https://github.com/alexandervanhee/gradia
Make your screenshots ready for all
https://github.com/alexandervanhee/gradia
gnome gradient gtk gtk4 image-manipulation libadwaita python
Last synced: 7 months ago
JSON representation
Make your screenshots ready for all
- Host: GitHub
- URL: https://github.com/alexandervanhee/gradia
- Owner: AlexanderVanhee
- License: gpl-3.0
- Created: 2025-05-18T14:46:17.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2025-06-16T10:45:30.000Z (8 months ago)
- Last Synced: 2025-06-16T10:49:14.352Z (8 months ago)
- Topics: gnome, gradient, gtk, gtk4, image-manipulation, libadwaita, python
- Language: Python
- Homepage:
- Size: 4.28 MB
- Stars: 147
- Watchers: 2
- Forks: 11
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- License: COPYING
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Gradia
Make your screenshots ready for the world.
On social media, it's often hard to control how your images appear to others.
Transparent or oddly sized images—like screenshots—often don't display well.
Fixing these issues can feel like more trouble than it's worth.
Gradia aims to alleviate that problem by allowing you to quickly edit images to address these issues,
while also offering options to enhance their overall appearance.
---
Gradia allows you to quickly modify screenshots of application windows to put them better in context.
> [!IMPORTANT]
> The [GNOME Code of Conduct](https://conduct.gnome.org) applies to this project, including this repository.
## Automatically Open the App After Taking a Screenshot
If you'd like Gradia to **open automatically** after taking a screenshot, you can set up a custom keyboard shortcut:
1. Go to **Settings** → **Keyboard** → **View and Customize Shortcuts** → **Custom Shortcuts**.
2. Click the **+** button to create a new shortcut.
3. Set the **Name** to something like *Open Gradia with Screenshot*.
4. For the **Command**, enter:
```
flatpak run be.alexandervanhee.gradia --screenshot=INTERACTIVE
```
(You can also use `--screenshot=FULL` to take a screenshot of all existing screens instantly.)
5. Assign a keyboard shortcut of your choice (`Ctrl + Print` should be free by default).
## Screenshots
## Unofficial packages
> [!WARNING]
> These methods are not officially supported. Issues related to packaging in these methods should be reported outside this project's bug tracker.
[](https://repology.org/project/gradia/versions)
## How to build
### GNOME Builder
1. Install Builder from [Flathub](https://flathub.org/apps/org.gnome.Builder).
2. Click the **Clone Repository** button at the bottom right and enter the repository URL.
3. Once cloned, locate the dropdown menu next to the `be.alexandervanhee.gradia.json` text at the top of the screen.
4. Use the dropdown to press **Build** to compile the project. From the same menu, you can also **Run** the project or **Export** it as a Flatpak bundle.