Gear Lever

<p align="center"> <img width="150" src="data/icons/hicolor/scalable/apps/it.mijorus.gearlever.svg"> </p> <p align="center"><img width="100" src="https://img.shields.io/flathub/downloads/it.mijorus.gearlever"></p>

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

<a href="https://flathub.org/apps/details/it.mijorus.gearlever" align="center"> <img width="240" src="https://flathub.org/api/badge?svg&locale=en" alt="Get it on Flathub"> </a>

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

<a href="https://ko-fi.com/mijorus" align="center"> <img width="250" src="https://mijorus.it/kofi-support.png"> </a>

---

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

<p align="center"> <img width="850" src="https://raw.githubusercontent.com/mijorus/gearlever/master/docs/gearlever3.png"> </p>

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