2023-07-12 16:53:26 -04:00
# Image Viewer (Loupe)
2020-12-26 02:05:34 -08:00
2023-04-13 21:49:42 +02:00
An image viewer application written with GTK 4, Libadwaita and Rust.
2020-12-26 02:05:34 -08:00
2023-07-12 16:53:26 -04:00

2020-12-26 02:05:34 -08:00
2022-12-08 17:55:20 +01:00
## Installing
The latest version from the main branch is available from the build artifacts.
2023-02-18 20:43:10 -05:00
Download bundle for:
2022-12-08 17:55:20 +01:00
2023-02-18 20:43:10 -05:00
* [x86_64 ](https://gitlab.gnome.org/api/v4/projects/13923/jobs/artifacts/main/raw/org.gnome.Loupe.Devel.flatpak?job=flatpak ) (Average desktop or laptop PC)
* [aarch64 ](https://gitlab.gnome.org/api/v4/projects/13923/jobs/artifacts/main/raw/org.gnome.Loupe.Devel.flatpak?job=flatpak@aarch64 ) (Average phone, tablet, or Apple Silicon devices)
Bundles will not be automatically updated after installation.
2020-12-26 02:05:34 -08:00
2023-04-13 21:49:42 +02:00
## Features
- Fast GPU accelerated image rendering with tiled rendering for SVGs
2023-07-12 16:53:26 -04:00
- Extendable and sandboxed (expect SVG) image decoding
2023-05-23 01:49:40 +02:00
- Support for more than 15 image formats by default
2023-04-13 21:49:42 +02:00
- Extensive support for touchpad and touchscreen gestures
- Accessible presentation of the most important metadata
- Sleek but powerful interface developed in conjunction with GNOME Human Interface Guidelines
decoder: Use image-rs, libheif-rs, librsvg
This adds proper support for a lot of image formats including SVGs.
It will be the basis for many features to come. The technical core
is an asynchronous renderer that can arrange textures in smaller tiles
which might be generated on demand.
Closes #34, #40, #41, #49
Basis for fixing the following issues #7, #27, #36, #43, #68, #71
2023-03-04 03:14:52 +01:00
## Supported Formats
2023-07-12 16:53:26 -04:00
Image Viewer uses [glycin ](https://gitlab.gnome.org/sophie-h/glycin ) for loading images. You can check [glycin's README ](https://gitlab.gnome.org/sophie-h/glycin#supported-image-formats ) for more details about the formats supported by the default loaders. However, glycin supports adding loaders for additional formats. Therefore, the supported formats on your system may vary and might be changed by installing or removing glycin loaders.
decoder: Use image-rs, libheif-rs, librsvg
This adds proper support for a lot of image formats including SVGs.
It will be the basis for many features to come. The technical core
is an asynchronous renderer that can arrange textures in smaller tiles
which might be generated on demand.
Closes #34, #40, #41, #49
Basis for fixing the following issues #7, #27, #36, #43, #68, #71
2023-03-04 03:14:52 +01:00
2020-12-26 02:05:34 -08:00
## Building
### GNOME Builder
GNOME Builder is the environment used for developing this application. It can use Flatpak manifests to create a consistent building and running environment cross-distro. Thus, it is highly
recommended you use it.
1. Download [GNOME Builder ](https://flathub.org/apps/details/org.gnome.Builder ).
2023-06-10 17:15:24 +03:00
2. In Builder, click the "Clone Repository" button at the bottom, using `git@ssh.gitlab.gnome.org:GNOME/Incubator/loupe.git`
or `https://gitlab.gnome.org/GNOME/Incubator/loupe.git` as the URL.
2020-12-26 02:05:34 -08:00
3. Click the build button at the top once the project is loaded.
## Installation
Depending on how you want it installed instructions can differ. If you
used GNOME Builder to build it, clicking the bar at the top window will
2023-02-18 20:43:10 -05:00
open a submenu with "Export Bundle". This will create a flatpak bundle,
2020-12-26 02:05:34 -08:00
which can be installed on any system that supports flatpak.
2023-07-12 16:53:26 -04:00
**In order for the Image Viewer flatpak to be able to read the directory images are installed in, you must install a bundle.**
2021-09-28 18:38:01 -07:00
Once you have a bundle installed, development builds will work properly.
2023-02-02 06:26:52 +01:00
## Contributing
2023-06-10 17:15:24 +03:00
- [Code Documentation ](https://gnome.pages.gitlab.gnome.org/Incubator/loupe/doc/loupe/ )
2023-02-02 06:26:52 +01:00
### Conduct
2020-12-26 02:05:34 -08:00
2023-07-12 16:53:26 -04:00
Image Viewer operates under the GNOME Code Of Conduct. See the full
2020-12-26 02:05:34 -08:00
text of the Code Of Conduct [here ](CODE_OF_CONDUCT.md ).