Skip to content

Repository files navigation

cosmic-viewer

Image viewer for the COSMIC desktop environment.

Browsing a folder in COSMIC Viewer

COSMIC Viewer is a fast image viewer and markup tool for the COSMIC desktop environment. It opens a wide range of formats, browses folders with a thumbnail sidebar, and provides non-destructive editing and markup, following the COSMIC design language with light and dark theming.

Features

  • Browse and view an image or a whole folder with a thumbnail sidebar
  • Navigation sorted by name, date, or size, with an adjustable thumbnail size
  • Viewing with zoom, pan, fit-to-window, actual size, and fullscreen
  • EXIF-aware image details
  • Non-destructive editing: crop, rotate, undo/redo, and revert all
  • Annotation: freehand pen, highlighter, shapes (rectangle, ellipse, arrow, line, star, polygon), and text
  • Custom colors via a hex/RGB picker with recent colors
  • Clipboard: copy the image or its file path
  • Save in place
  • Save As a new file
  • Set as wallpaper on the current or all displays
  • Move to trash from within the viewer

Screenshots

Marking up a reference image Shape tools
Freehand, highlighter, shapes, and text markup Shapes: rectangle, ellipse, arrow, line, star, polygon
Custom color picker Cropping
Custom hex/RGB colors with recent swatches Non-destructive cropping with custom and aspect-ratio presets
Right-click actions Wallpaper applied to the desktop
Copy, image details, set as wallpaper, move to trash Any image, set as the COSMIC desktop wallpaper

Supported formats

JPEG, PNG, GIF, WebP, BMP, TIFF, ICO, AVIF, HEIF/HEIC, JPEG XL, SVG, QOI, Radiance HDR, the Netpbm family (PPM, PGM, PBM, PNM), and Farbfeld.

Build the project from source

# Clone the project using `git`
git clone https://github.com/pop-os/cosmic-viewer
# Change to the directory that was created
cd cosmic-viewer
# Build and run an optimized version using `just`, this may take a while
just run-release

Install

# Build and install to /usr using the bundled recipe (requires `just`)
just install

Community and Contributing

The COSMIC desktop environment is maintained by System76 for use in Pop!_OS. A list of all COSMIC projects can be found in the cosmic-epoch project's README. If you would like to discuss COSMIC and Pop!_OS, please consider joining the Pop!_OS Chat. More information and links can be found on the Pop!_OS Website.

License

This project is licensed under GPLv3

About

COSMIC Image Viewer

Resources

Stars

15 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages