{"id":28410608,"url":"https://github.com/alexandervanhee/gradia","last_synced_at":"2025-07-09T08:10:50.862Z","repository":{"id":294035365,"uuid":"985795473","full_name":"AlexanderVanhee/Gradia","owner":"AlexanderVanhee","description":"Make your screenshots ready for all","archived":false,"fork":false,"pushed_at":"2025-06-16T10:45:30.000Z","size":4487,"stargazers_count":147,"open_issues_count":18,"forks_count":11,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-16T10:49:14.352Z","etag":null,"topics":["gnome","gradient","gtk","gtk4","image-manipulation","libadwaita","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlexanderVanhee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null}},"created_at":"2025-05-18T14:46:17.000Z","updated_at":"2025-06-16T10:33:56.000Z","dependencies_parsed_at":"2025-06-16T10:34:11.821Z","dependency_job_id":"8990852f-1533-4455-89b1-bbebc1a847cd","html_url":"https://github.com/AlexanderVanhee/Gradia","commit_stats":null,"previous_names":["alexandervanhee/gradia"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/AlexanderVanhee/Gradia","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexanderVanhee%2FGradia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexanderVanhee%2FGradia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexanderVanhee%2FGradia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexanderVanhee%2FGradia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlexanderVanhee","download_url":"https://codeload.github.com/AlexanderVanhee/Gradia/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexanderVanhee%2FGradia/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261197305,"owners_count":23123686,"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":["gnome","gradient","gtk","gtk4","image-manipulation","libadwaita","python"],"created_at":"2025-06-02T12:06:52.112Z","updated_at":"2025-07-09T08:10:50.857Z","avatar_url":"https://github.com/AlexanderVanhee.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"data/icons/hicolor/scalable/apps/be.alexandervanhee.gradia.svg\" alt=\"Gradia Logo\" height=\"128\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eGradia\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\u003cem\u003eMake your screenshots ready for the world.\u003c/em\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  On social media, it's often hard to control how your images appear to others.\n  Transparent or oddly sized images—like screenshots—often don't display well.\n  Fixing these issues can feel like more trouble than it's worth.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Gradia aims to alleviate that problem by allowing you to quickly edit images to address these issues,\n  while also offering options to enhance their overall appearance.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://flathub.org/apps/be.alexandervanhee.gradia\"\u003e\n    \u003cimg width=\"190\" alt=\"Download on Flathub\" src=\"https://flathub.org/api/badge?locale=en\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\n---\n\u003cp align=\"center\" style=\"display: flex; justify-content: center; gap: 1em; flex-wrap: wrap;\"\u003e\n  \u003cimg alt=\"Flathub Downloads\" src=\"https://img.shields.io/flathub/downloads/be.alexandervanhee.gradia?logoColor=%234ec9a2\u0026label=Flathub%20installs\" /\u003e\n  \u003cimg alt=\"Flathub Version\" src=\"https://img.shields.io/flathub/v/be.alexandervanhee.gradia?label=Flathub%20version\" /\u003e\n  \u003cimg alt=\"GitHub License\" src=\"https://img.shields.io/github/license/AlexanderVanhee/Gradia\" /\u003e\n\u003c/p\u003e\n\n\nGradia allows you to quickly modify screenshots of application windows to put them better in context.\n\n\u003e [!IMPORTANT]\n\u003e The [GNOME Code of Conduct](https://conduct.gnome.org) applies to this project, including this repository.\n## Automatically Open the App After Taking a Screenshot\n\nIf you'd like Gradia to **open automatically** after taking a screenshot, you can set up a custom keyboard shortcut:\n\n1. Go to **Settings** → **Keyboard** → **View and Customize Shortcuts** → **Custom Shortcuts**.\n2. Click the **+** button to create a new shortcut.\n3. Set the **Name** to something like *Open Gradia with Screenshot*.\n4. For the **Command**, enter:\n\n   ```\n   flatpak run be.alexandervanhee.gradia --screenshot=INTERACTIVE\n   ```\n   (You can also use `--screenshot=FULL` to take a screenshot of all existing screens instantly.)\n5. Assign a keyboard shortcut of your choice (`Ctrl + Print` should be free by default).\n\n## Screenshots\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"screenshots/showcase.webp\" alt=\"Showcase screenshot\" style=\"width:45%; margin-right: 5%;\"\u003e\n  \u003cimg src=\"screenshots/home.webp\" alt=\"Home screenshot\" style=\"width:45%;\"\u003e\n\u003c/p\u003e\n\n## Unofficial packages\n\u003e [!WARNING]\n\u003e These methods are not officially supported. Issues related to packaging in these methods should be reported outside this project's bug tracker.\n\n[![Packaging status](https://repology.org/badge/vertical-allrepos/gradia.svg)](https://repology.org/project/gradia/versions)\n\n## How to build\n\n### GNOME Builder\n\n1. Install Builder from [Flathub](https://flathub.org/apps/org.gnome.Builder).\n2. Click the **Clone Repository** button at the bottom right and enter the repository URL.\n3. Once cloned, locate the dropdown menu next to the `be.alexandervanhee.gradia.json` text at the top of the screen.\n4. 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexandervanhee%2Fgradia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexandervanhee%2Fgradia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexandervanhee%2Fgradia/lists"}