Linepipe

A Modern GNOME Interface for Pipx packages.

Linepipe lets you install, upgrade, uninstall, inject, and run pipx-managed Python applications through a native GNOME interface — no terminal required.

Current version: 1.0.0. See CHANGELOG.md for release notes.

To support and maintain this project !

---

Features

• List installed packages with version, Python version, exposed apps, and injected deps
• Install packages from PyPI with optional version pinning, --include-deps, and custom Python
• Upgrade individual packages or all at once (pipx upgrade-all)
• Uninstall with confirmation dialog
• Inject / Uninject extra dependencies into existing pipx venvs
• Run exposed application binaries with optional arguments
• Outdated detection — checks PyPI JSON API in the background, highlights outdated packages
• Search PyPI — filter installed list instantly; press Enter for exact PyPI lookup
• Desktop notifications on operation success/failure
• GNOME HIG compliant — Adwaita styling, toast notifications, dark/light mode

---

Keyboard shortcuts

Shortcut	Action
Ctrl+R / F5	Refresh installed list
Ctrl+F	Focus search bar
Ctrl+P	Open Preferences
Ctrl+I	Open Install dialog
?	Show keyboard shortcuts
Ctrl+Q	Quit

---

Requirements

• Linux with GTK 4.0+ and libadwaita 1.0+
• Python 3.11+
• PyGObject 3.44+
• pipx (to actually manage packages)

---

Installation

Source install (advanced)

Linepipe can currently be installed from source by experienced users who trust the checkout. This runs local Python packaging code, so review the repository and verify the source before installing.

git clone https://github.com/Torcken/linepipe.git
cd linepipe
bash install.sh

Install GTK4, libadwaita, PyGObject, pip, and pipx with your distro package manager first. The default installer does not run sudo; it checks runtime dependencies, installs Linepipe with pip, and registers desktop files/icons.

To let the installer prompt before installing distro packages:

bash install.sh --install-system-deps

To check runtime dependencies without installing:

bash install.sh --check-deps

Signed .deb and .rpm packages are planned as the beginner-friendly install path. Until those packages are published, source install remains the supported advanced path.

Uninstall

bash uninstall.sh

---

Usage

Launch from your application menu or run:

linepipe

Development

Install development tools in an environment that already has GTK4, libadwaita, and PyGObject available:

python -m pip install -e ".[dev]"

Run the core checks:

python -m compileall linepipe
pytest
desktop-file-validate data/io.github.torcken.linepipe.desktop
appstreamcli validate --no-net data/io.github.torcken.linepipe.metainfo.xml

Run the full release gate, including build artifact inspection:

./release-check.sh

Before changing the public version, update all version markers together:

• VERSION
• version in pyproject.toml
• __version__ in linepipe/__init__.py
• CHANGELOG.md

For local manual testing without installing desktop files:

./start.sh

Security

Source installation is intended for experienced users who trust the checkout. For release verification and vulnerability reporting, see VERIFYING.md and SECURITY.md.

To support and maintain this project !

---

License

Linepipe is licensed under the GNU General Public License v3.0 or later. See LICENSE for details.

---

Made with 🤍 by Torcken