https://github.com/taiko2k/avvie

A GTK app for quick image cropping :flower_playing_cards:
https://github.com/taiko2k/avvie

Last synced: about 22 hours ago
JSON representation

A GTK app for quick image cropping :flower_playing_cards:

• Host: GitHub
• URL: https://github.com/taiko2k/avvie
• Owner: Taiko2k
• License: gpl-3.0
• Created: 2019-07-28T12:03:20.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-09-14T13:20:22.000Z (3 months ago)
• Last Synced: 2024-12-15T19:10:14.137Z (8 days ago)
• Language: Python
• Homepage:
• Size: 224 KB
• Stars: 159
• Watchers: 8
• Forks: 18
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG
  • License: LICENSE

Awesome Lists containing this project

README

        



## 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.



### 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](https://repology.org/badge/vertical-allrepos/avvie.svg)](https://repology.org/project/avvie/versions)

## 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

```