mijorus/gearlever
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Manage AppImages with ease 📦 https://gearlever.mijorus.it
926 commits 23 branches 91 tags 89 MiB
  • Python 98.1%
  • Meson 1.3%
  • Shell 0.4%
  • CSS 0.2%
Find a file
Exact
Lorenzo Paderi f536840900
 Merge pull request #403 from salim-b/patch-1 
docs(metainfo): Add link to source repo
2026-02-02 15:16:04 +01:00
.github updated release yml 2025-12-09 10:01:05 +01:00
.vscode updated settings.json 2024-11-05 09:48:08 +01:00
build-aux Use more compatible POSIX script for get_appimage_offset.sh 2025-11-23 12:02:15 +01:00
data Merge pull request #403 from salim-b/patch-1 2026-02-02 15:16:04 +01:00
docs updated screenshots 2024-07-07 09:44:46 +00:00
po Added missing pt-PT translations. 2026-02-01 18:51:16 +00:00
src added support for pre-releases embedded in github update url 2026-02-02 15:13:41 +01:00
tests test cli: added tests for static file updater 2025-12-22 11:06:23 +01:00
.gitignore updated gitignore 2025-10-30 15:02:49 +01:00
COPYING first commit 2023-05-19 16:44:03 +02:00
gearlever.code-workspace added update all btn 2025-04-02 09:14:47 +02:00
it.mijorus.gearlever.json updated sqashfs 2025-12-03 11:12:12 +01:00
meson.build version bump 2026-02-02 15:13:58 +01:00
pyrightconfig.json Update pyrightconfig.json 2024-10-02 08:51:58 +02:00
python3-requirements.json added desktop-entry-lib 2025-11-25 09:08:33 +01:00
README.md Add documentation section to README 2026-01-17 08:42:14 +01:00
requirements.txt added desktop-entry-lib 2025-11-25 09:08:33 +01:00

README.md

Gear Lever

Documentation

https://gearlever.mijorus.it

Features

  • Integrate AppImages into your app menu with just one click
  • Drag and drop files directly from your file manager
  • Keep all the AppImages organized in a custom folder
  • Open new AppImages directly with Gear lever
  • Manage updates: keep older versions installed or replace them with the latest release
  • Save CLI apps with their executable name automatically
  • Modern and Fresh UI

Download

Get it on Flathub

CLI

Starting from version 3.0.0, Gear Lever includes some useful command line tools to manage your AppImages. The CLI uses the same logics as the UI.

Please use flatpak run it.mijorus.gearlever --help to get an updated version of this help screen

Usage: flatpak run it.mijorus.gearlever [OPTION...]
# OR gearlever [OPTION...] if using the alias


--integrate        Integrate an AppImage file
--update           Update an AppImage file
--remove           Trashes an AppImage, its .desktop file and icons
--list-installed   List integrated apps
--list-updates     List available updates
--set-update-url   Set/Unset a custom update url
--fetch-updates    Fetch updates in the background and sends a desktop notification, used on system startup

For an improved user experience, add the following line to your .bashrc file

alias gearlever='flatpak run it.mijorus.gearlever'

Support me

Get the bundle from github (no auto-updates)

# From your Downloads folder
flatpak install --bundle --user gearlever.flatpak

Changelog

Open changelog

Permissions

  • --talk-name=org.freedesktop.Flatpak: This permission is required in order to open apps and refresh the system menu when a new app is installed; if the user disables this permission manually (eg. with Flatseal), Gear lever should continue to work normally, except you would not be able to open apps directly.

Preview

Building and running

  • Option #1 (suggested)

    Open this project with Gnome Builder and press RUN (the play icon on top)

  • Option #2

    # Run the app
flatpak-builder build/ it.mijorus.gearlever.json --user --force-clean
flatpak-builder --run build/ it.mijorus.gearlever.json gearlever

# Install the app
flatpak-builder build/ it.mijorus.gearlever.json --user --install --force-clean

Run CLI tests

  1. Download the latest release here: https://github.com/mijorus/gearlever-test-files
  2. Pleace if under test/
  3. Extract it tar -xzvf testfiles.tar.gz
  4. Run:
python3 -m unittest tests/test_cli.py