LinuxToys

LinuxToys is a collection of user-friendly tools designed for Linux systems. It aims to make powerful Linux functionality accessible to all users through an intuitive interface. For a complete feature list and detailed documentation, please visit our Wiki.

Compatibility

LinuxToys is compatible with the following Linux distributions, provided they are running their latest stable versions:

• Debian and derivatives (Ubuntu, Linux Mint, etc.)
• Fedora and derivatives (RHEL, CentOS, AlmaLinux, etc.)
• Arch Linux and derivatives (Manjaro, EndeavourOS, etc.)
• OpenSUSE (Leap and Tumbleweed)
• Atomic Distributions (Atomic Fedora, Universal Blue images like Bazzite, Bluefin, Aurora)

Installation

Automatic Installation

The simplest way to install LinuxToys is by using the automated installation script. Open your terminal and run:

curl -fsSL https://linux.toys/install.sh | bash

Manual Installation

If you prefer to review the script before running it, you can download and execute it manually:

curl -fsSLJO https://linux.toys/install.sh
chmod +x install.sh
./install.sh

Official Repositories

LinuxToys is available in several official and community repositories for easier package management.

Ubuntu (PPA)

You can install LinuxToys from our official PPA on Launchpad:

sudo add-apt-repository ppa:psygreg/linuxtoys
sudo apt update
sudo apt install linuxtoys

Fedora / RHEL / OpenSUSE (COPR)

Packages are available via Fedora COPR for AlmaLinux 10, Fedora 41/42, OpenSUSE Leap/Tumbleweed, and RHEL 9/10.

For Standard Systems:

sudo dnf copr enable psygreg/linuxtoys
sudo dnf install linuxtoys

For Atomic Systems (Fedora Atomic, Universal Blue):

curl -fsSL https://copr.fedorainfracloud.org/coprs/psygreg/linuxtoys/repo/fedora-$(rpm -E %fedora)/psygreg-linuxtoys-fedora-$(rpm -E %fedora).repo | sudo tee /etc/yum.repos.d/psygreg-linuxtoys-fedora-$(rpm -E %fedora).repo
sudo rpm-ostree install linuxtoys

Arch Linux (AUR)

Arch Linux users can install the linuxtoys-bin package from the AUR:

git clone https://aur.archlinux.org/linuxtoys-bin.git
cd linuxtoys-bin
makepkg -si

Development

For developers who wish to contribute or run the application from source, please follow these steps.

Prerequisites

Ensure your system has the necessary dependencies installed.

Debian/Ubuntu:

sudo apt install -y bash git curl wget zenity python3 python3-gi python3-requests libgtk-3-0 gir1.2-gtk-3.0 gir1.2-vte-2.91

Fedora/RHEL:

sudo dnf install -y bash git curl wget zenity python3 python3-gobject python3-requests gtk3 vte291

Arch Linux:

sudo pacman -S --noconfirm bash git curl wget zenity python python-gobject python-requests gtk3 vte3

OpenSUSE:

sudo zypper in -y bash git curl wget zenity python3 python3-gobject python3-requests gtk3 libvte-2_91-0 typelib-1_0-Vte-2.91

Cloning and Running

Clone the repository:

    git clone --depth=1 https://github.com/psygreg/linuxtoys.git
    cd linuxtoys

Install Dependencies:

Option 1: Virtual Environment (Recommended)

Create an isolated environment to avoid conflicts with system packages.

python3 -m venv .venv
source .venv/bin/activate
pip install -r p3/requirements.txt

Option 2: Direct Installation (Not Recommended)

Caution

Installing packages globally can conflict with your system's package manager and cause instability.

pip install -r p3/requirements.txt

Run the application:

python3 p3/run.py

Update the application:

git pull

For more comprehensive developer documentation, please refer to the Developer Guide.

Contributing

We welcome contributions! If you are interested in helping improve LinuxToys, please review our Contribution Guidelines.

Credits

This project is made possible by the community. For a full list of contributors, please visit our Credits Page.