Skip to content

About

Show, hide and edit app launcher entries on Linux: autostart, web apps, AppImage removal and styled icons. GTK 4, Material 3 Expressive.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

App Entries

App Entries

A GTK 4 app for Linux that hides, shows and edits app launcher entries. It can also make launchers and web apps, manage autostart entries, choose default apps and uninstall apps. It only changes files in your home folder; uninstalling a package runs your package manager in your own terminal.

Version 1.3.0 License: MIT Linux Python 3.9+ GTK 4 Material 3 Expressive

Install · Features · How it works · Shortcuts · Changelog

App Entries in dark mode: a list of apps beside the selected app's page, which shows how it looks in a launcher, a switch to hide it and its settings


AI disclosure: This project was written almost entirely by an AI assistant, with direction and testing by the author. It has been tested on Arch Linux with Hyprland, but not yet on every desktop, so review the code before relying on it.

Features

Apps

  • Every installed app in one searchable list: system packages, Flatpak, Snap, AppImage, Steam and your own launchers. Shown, Hidden or All, so hundreds of hidden apps stay out of the way; a Filter menu narrows it to one source, customised or new apps.
  • Hide or show an app with the eye on its row, Space, or the switch on its page. Hidden apps still open links and files, and stay in "Open With".
  • Each app has a page beside the list: how it looks in your launcher, its name, icon and command (edited right there, with Save and Discard), the file types it opens, whether it starts at login, helper apps, the changes made to it with Undo, and Uninstall. Unsaved edits are kept while you look at other apps.
  • Installation details at the bottom of each app's page: its package, version and where it came from (your distribution, the AUR, a PPA, Flathub, a Snap channel), when it was installed, whether it was installed directly or for another package (and by whom, where apt records it), who it's installed for and its size. Dependencies open to show what it needs, what needs it and optional extras. For an AppImage or a program no package owns: its file, the web address it was downloaded from, and the GitHub project its updates come from. Launchers made with App Entries, games from Heroic, Lutris and Bottles, Waydroid's Android apps, JetBrains Toolbox apps and Windows programs run with Wine are each described as what they are, with real folder sizes. For a Flatpak, what it can reach (files, network, devices…) in plain words, with Flatseal a click away. The page opens at once and these fill in from the background; answers are remembered until something is installed or removed.
    The Installation section of an AppImage's page: its file, where it was downloaded from, and its GitHub project with a newer version ready to update
  • Apps from GitHub: an AppImage's page shows the GitHub project it comes from (from its update information or where it was downloaded), or you can link one. Check for updates when you choose, see what's new, and update with one button: the new AppImage for your processor is downloaded and checked, the launcher points at it and the old file goes to the Trash, with Undo. Apps installed with pip, pipx or uv, git copies of projects, and .deb or .rpm packages downloaded from GitHub are recognised too, with an update run in your terminal.
  • Select several to hide, show, restore, restyle or uninstall many apps at once.
  • Edit any entry (name, icon, command, environment, folders, desktops, quick actions) with a live view of the file. Editing a system app saves your own copy; Restore original puts it back.
  • Open any app from its page or right-click menu, hidden ones included. Sort A–Z or newest first; apps that appeared since App Entries last looked are marked New until you open them or start App Entries again.
  • Issues finds leftover files, missing programs and duplicates, and explains each with a button to fix it.
    Issues listing an entry whose program isn't installed, with a button to hide it
  • Apps you edited and then uninstalled some other way are hidden from menus with your edits kept, and the edits apply again if you reinstall. Both are options in Issues, each done once with Undo.
  • When the list is empty because of the search or the filters, it says how many apps they leave out, with a button to lift each. While searching Shown, it also says when hidden apps match.
  • Uninstall… for Flatpak, Snap, AppImage, Steam, Distrobox, system packages (pacman, apt, dnf, zypper, rpm-ostree, xbps, apk, eopkg, Portage and Nix), apps installed with pip, pipx or uv, app folders and git copies in your home folder, and games from Heroic, Lutris and other launchers (handed to the launcher, as with Steam). Before anything runs it shows what goes, which other apps and packages need it or go with it, whether it's a default app or starts at login, and the exact command. Data folders and advanced options (like removing what depends on it) are off unless you turn them on, with warnings. Commands that need a password run in your terminal; packages the system or your desktop needs are never offered. History keeps a Reinstall button.
  • Helper apps… shortcuts to the apps that set up what App Entries doesn't, opened on that app where they allow it: Flatseal, Warehouse, Gear Lever, ProtonUp-Qt, Protontricks, BoxBuddy, DistroShelf, GNOME Settings' and KDE's app permissions, your software centre and Steam. Missing ones show what they do and the Flathub command, run in your terminal only if you ask.

The Uninstall window for a Flatpak: what's removed, its data and unused runtime as options that are off, and the command it runs

Launchers

  • New launcher for a program or script, or for commands written as in a terminal (paru -Syu && flatpak update, pipes, loops, whole scripts) run by the shell you choose. Add more sets of commands to open each in its own terminal. Terminal options and a live preview of the entry.
    Editing a launcher that runs commands with bash: paru -Syu and flatpak update in one terminal, journalctl -f in another
  • Add what you downloaded: an AppImage (its name, icon and file types are read from inside it, without running it), an app folder from a tar.gz or zip, a Windows program (run with Wine or Proton), a Java app, a .desktop file that came with an app, or an app from a Distrobox container. Launchers also lists AppImages, app folders and Windows programs it finds in ~/Applications, ~/AppImages, ~/Games and ~/Downloads that have no launcher yet. AppImages can move to ~/Applications, and later point at a newer download.
  • Install from GitHub: paste a project's link, pick a version, and App Entries installs the file that fits your computer (AppImage, app archive, package or Flatpak bundle), checks it against the release's checksums, and makes the launcher. Projects with only source code get the usual pipx, uv, cargo, go or npm command, run in your terminal.
  • New web app: a site in its own window with no address bar or tabs, using a Chromium-based browser. It shares your browser's sign-ins, or keeps its own, with an optional dark mode and a window name for docks and window rules.
  • Styled icons from 4,000 Material Symbols or your own SVGs: tile shape, colour, shading, size and border, with a built-in colour picker. Paste SVG code, download from a link, or use a site's icon.
    The icon picker: a grid of symbols, and the style, background, shading, size and colour of the tile

More

  • Tools: command-line tools without a menu entry: ones in your home folder (cargo, go install, pipx, uv, npm or files in ~/.local/bin) and terminal programs you installed with your package manager (pacman, apt, dnf, zypper, rpm-ostree, xbps, apk, Portage, Nix), with version, size and project, and Update or Remove run in your terminal.
    Tools: ripgrep and zellij from cargo, lazygit from go install, black from pipx and a script in ~/.local/bin, each with Update and Remove
  • Autostart: turn login programs on and off, or add your own.
  • Default apps: choose which app opens links, email, folders, text, PDFs, pictures, videos, music and archives, for a whole kind or each type on its own. By app lists every file type one app opens (File types… on its page) and makes it the default for any of them. Uses the standard mimeapps.list, and also updates Xfce's and KDE's own browser settings.
    Default apps: web browser, email, files, text, PDFs, pictures, videos and music, each with the app that opens them
  • History of every change, each with Undo, kept between sessions.
  • Export / Import your changes to set up another computer.
  • Updates: App Entries' own updates with one button. It also watches your other apps that the system's package manager doesn't update (AppImages, apps from GitHub, pip/pipx/uv apps, git copies, tools and Flatpaks), once a day: a small dot marks one with a newer version, and its page has the Update button.
  • A command line for scripts, and full keyboard and screen reader support.
  • Light and dark themes and a responsive layout. The accent can follow your desktop's (GNOME and KDE settings, or the colours Noctalia, matugen, wallust and other theme tools write for GTK apps), and palettes like Catppuccin, Gruvbox, Nord, Rosé Pine, Tokyo Night, Everforest and Solarized restyle the whole app.
    Settings: accent colours with a colour picker, palettes, light or dark, and size

Nothing happens by itself: every option is explained, nothing is written until you press a button, and every change can be undone. The one exception is hiding edited apps that were uninstalled (and showing them again on reinstall), which is on by default, shows a message with Undo, and can be turned off in Issues. App Entries never changes system files itself; only a package manager you run from it, in your terminal, does.

Installation

git clone https://github.com/HypestHyper/AppEntries.git
cd AppEntries
./install.sh                  # installs to ~/.local

Needs Python 3.9+, GTK 4.6+ and PyGObject. The installer shows the command for your distribution and asks before installing anything missing (--yes to skip the question). Use sudo ./install.sh --system for /usr/local, or --prefix DIR.

Updates come from Updates, at the bottom of the side rail. To remove it, run ./uninstall.sh (same options). Add --restore-apps to show the apps you hid and turn login programs back on, and --purge to delete settings.

How it works

Launchers read .desktop files from ~/.local/share/applications before the system folders, so a file there with the same name wins. Hiding an app writes a copy of its entry there with NoDisplay=true, marked with a checksum so App Entries can tell if you edit it. Showing it again deletes the copy, or removes just that line from a file of your own. Launchers that run commands keep them in a small script in ~/.local/share/app-entries/scripts, which the entry runs with your chosen shell, so every launcher can start them. Autostart works the same way in ~/.config/autostart. Default apps are written to ~/.config/mimeapps.list, the standard file desktops and apps read to decide what opens links and files.

This follows the Desktop Entry Specification, so it works with GNOME, KDE Plasma, Xfce, Cinnamon, rofi, wofi, fuzzel and other launchers that read .desktop files.

Command line

app-entries --list --hidden          # ID, state and name
app-entries --hide steam discord     # by ID or name
app-entries --unhide steam
app-entries --export ~/apps.json     # and --import, which lists the changes first
app-entries --refresh-launchers
app-entries --uninstall discord      # shows what goes and the command, then asks

Add --yes to skip questions in scripts. See app-entries --help.

Keyboard shortcuts

Keys Action
Ctrl+F, or start typing Search
Alt+1 … Alt+7 Go to Apps, Launchers, Issues, Autostart, Defaults, Updates or Settings
Ctrl+N / Ctrl+Shift+N New launcher / New web app
Enter or a click on an app Open its page
Space on an app Hide or show it
Menu or Shift+F10 on an app Its options
Ctrl+S Save the changes on an app's page
Esc Back to the list (narrow windows), or close History
Ctrl+Z Undo the last change
Ctrl+H History, at the side
Ctrl+R Refresh
Ctrl+, Settings

Files

What Where
Hidden and edited apps, launchers you make ~/.local/share/applications/
Login programs you changed ~/.config/autostart/
Default apps ~/.config/mimeapps.list
Your icons, web apps' own sign-ins ~/.local/share/app-entries/
History of changes ~/.local/state/app-entries/history.json

Development

python3 -m app_entries        # run from the source folder
python3 -m pytest tests       # tests use temporary folders, never your real ones

License

MIT, see LICENSE. Third-party assets are listed in THIRD_PARTY.md.

About

Show, hide and edit app launcher entries on Linux: autostart, web apps, AppImage removal and styled icons. GTK 4, Material 3 Expressive.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages