{"id":13780606,"url":"https://github.com/artemsen/swayimg","last_synced_at":"2025-10-21T13:06:03.808Z","repository":{"id":37865418,"uuid":"284720432","full_name":"artemsen/swayimg","owner":"artemsen","description":"Image viewer for Wayland","archived":false,"fork":false,"pushed_at":"2024-10-30T05:13:38.000Z","size":2439,"stargazers_count":365,"open_issues_count":11,"forks_count":30,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-10-30T08:32:31.548Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/artemsen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-03T14:21:48.000Z","updated_at":"2024-10-30T05:13:42.000Z","dependencies_parsed_at":"2023-02-15T22:00:27.882Z","dependency_job_id":"7880da8a-f312-457d-b9b7-59fd6b5bf98a","html_url":"https://github.com/artemsen/swayimg","commit_stats":{"total_commits":192,"total_committers":10,"mean_commits":19.2,"dds":0.06770833333333337,"last_synced_commit":"941d2fbe3c62f20de799fd89c873b94677118370"},"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artemsen%2Fswayimg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artemsen%2Fswayimg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artemsen%2Fswayimg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artemsen%2Fswayimg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/artemsen","download_url":"https://codeload.github.com/artemsen/swayimg/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225056843,"owners_count":17414221,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T18:01:17.758Z","updated_at":"2025-10-21T13:06:03.800Z","avatar_url":"https://github.com/artemsen.png","language":"C","funding_links":[],"categories":["Image Viewers"],"sub_categories":[],"readme":"# Swayimg: image viewer for Wayland\n\nFully customizable and lightweight image viewer for Wayland based display servers.\n\n- Support for the most popular image formats:\n  - JPEG (via [libjpeg](http://libjpeg.sourceforge.net)),\n  - JPEG XL (via [libjxl](https://github.com/libjxl/libjxl));\n  - PNG (via [libpng](http://www.libpng.org));\n  - GIF (via [giflib](http://giflib.sourceforge.net));\n  - SVG (via [librsvg](https://gitlab.gnome.org/GNOME/librsvg));\n  - WebP (via [libwebp](https://chromium.googlesource.com/webm/libwebp));\n  - HEIF/AVIF (via [libheif](https://github.com/strukturag/libheif));\n  - AV1F/AVIFS (via [libavif](https://github.com/AOMediaCodec/libavif));\n  - TIFF (via [libtiff](https://libtiff.gitlab.io/libtiff));\n  - Sixel (via [libsixel](https://github.com/saitoha/libsixel));\n  - Raw: CRW/CR2, NEF, RAF, etc (via [libraw](https://www.libraw.org));\n  - EXR (via [OpenEXR](https://openexr.com));\n  - BMP (built-in);\n  - PNM (built-in);\n  - TGA (built-in);\n  - QOI (built-in);\n  - DICOM (built-in);\n  - Farbfeld (built-in).\n- Fully customizable keyboard bindings, colors, and [many other](https://github.com/artemsen/swayimg/blob/master/extra/swayimgrc) parameters;\n- Loading images from files and pipes;\n- Gallery and viewer modes with slideshow and animation support;\n- Preload images in a separate thread;\n- Cache in memory, no data is written to permanent storage (HDD/SSD);\n- [Sway](https://swaywm.org) and [Hyprland](https://hyprland.org/) integration\nmode: the application creates an \"overlay\" above the currently active window,\nwhich gives the illusion that you are opening the image directly in a terminal\nwindow.\n\n![Viewer mode](https://raw.githubusercontent.com/artemsen/swayimg/master/.github/viewer.png)\n![Gallery mode](https://raw.githubusercontent.com/artemsen/swayimg/master/.github/gallery.png)\n\n## Usage\n\n`swayimg [OPTIONS]... [FILE]...`\n\nSee [man page](https://github.com/artemsen/swayimg/blob/master/extra/swayimg.1.scd?plain=1) for details.\n\nExamples:\n- View multiple files:\n  ```\n  swayimg photo.jpg logo.png\n  ```\n- Start slideshow for all files (recursively) in the current directory in random order:\n  ```\n  swayimg --slideshow --recursive --order=random\n  ```\n- View using pipes:\n  ```\n  wget -qO- https://www.kernel.org/theme/images/logos/tux.png | swayimg -\n  ```\n- Loading stdout from external commands:\n  ```\n  swayimg \"exec://wget -qO- https://www.kernel.org/theme/images/logos/tux.png\" \\\n          \"exec://curl -so- https://www.kernel.org/theme/images/logos/tux.png\"\n  ```\n- View all images from the current directory in gallery mode:\n  ```\n  swayimg --gallery\n  ```\n\n## Configuration\n\nThe viewer searches for the configuration file with name `config` in the\nfollowing directories:\n- `$XDG_CONFIG_HOME/swayimg`\n- `$HOME/.config/swayimg`\n- `$XDG_CONFIG_DIRS/swayimg`\n- `/etc/xdg/swayimg`\n\nSample file is available [here](https://github.com/artemsen/swayimg/blob/master/extra/swayimgrc) or locally `/usr/share/swayimg/swayimgrc`.\n\nSee [man page](https://github.com/artemsen/swayimg/blob/master/extra/swayimgrc.5.scd?plain=1) for details.\n\n## Install\n\n[![Packaging status](https://repology.org/badge/tiny-repos/swayimg.svg)](https://repology.org/project/swayimg/versions)\n\nList of supported distributives can be found on the [Repology page](https://repology.org/project/swayimg/versions).\n\nArch users can install the program from the extra repository: [swayimg](https://archlinux.org/packages/extra/x86_64/swayimg) or from AUR [swayimg-git](https://aur.archlinux.org/packages/swayimg-git) package.\n\n## Build\n\nThe project uses Meson build system:\n```\nmeson setup _build_dir\nmeson compile -C _build_dir\nmeson install -C _build_dir\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartemsen%2Fswayimg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fartemsen%2Fswayimg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartemsen%2Fswayimg/lists"}