/Avvie

A GTK app for quick image cropping :flower_playing_cards:

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Avvie!

A utility for quickly cropping images. Designed to be faster than the time it takes to locate the crop tool in GIMP.

Features

  • Quickly crop square images for avatars
  • Crop desktop wallpapers from photos
  • Scale images to preset output sizes
  • Support for lossless JPEG cropping (added in v2.4)
  • Quick saving
  • And more handy features





Usage tips

  • You can import by drag and drop from your Pictures folder
  • Click the thumbnail preview to toggle between square and circle. The output will still be square unless associated setting is also enabled in preferences.
  • Hold Shift to move the selection rectangle slowly
  • Tap Ctrl to enter free rectangle mode
  • You can type a custom ratio into the entry field next to the "Custom" option e.g. 4:3, then press Enter.
  • You can also type a custom crop resolution into that same field, e.g. 300,500.
  • If exporting for your Steam profile, select the "Downscale Max 184x184" option for a better quality upload.
  • [Permission workaround] Run sudo flatpak override com.github.taiko2k.avvie --filesystem=host to allow drag and drop from all file locations.

Install

Flatpak is the recommended way to install Avvie. You can get the latest version from flathub by clicking the button below.

Download on Flathub

Third Party Packages

You may also be able to obtain Avvie from your distribution's package manager. Note these packages are maintained independently and thus may differ from the official version on Flathub. Please report any issues experienced to the package maintainer.

Packaging status

Build from source

The easiest way to build is by cloning this repo with GNOME Builder. It will automatically resolve all relevant flatpak SDKs automatically. You can then export the bundle if you wish.

Alternatively, clone the repo and use the following commands to build with meson.

meson builddir --prefix=/usr/local
sudo ninja -C builddir install

To build a flatpak from the command line, use the following commands.

flatpak-builder --user --install flatpak-builddir com.github.taiko2k.avvie.json
flatpak run com.github.taiko2k.avvie