Skip to content

Home

Jump to bottom
Bocaletto Luca edited this page Aug 2, 2025 · 1 revision

Welcome to the PyStudioBand wiki!

PyStudioMusic

License: GPLv3 Platform

Professional GTK3 GUI manager for audio & music-production software on Debian and Ubuntu.

Table of Contents

Description

PyStudioMusic is a GTK3-based desktop application that lets you easily install, remove, launch and manage your favorite audio and music-production tools. It targets Debian/Ubuntu users who want a polished, intuitive interface for handling DAWs, editors, servers, synthesizers and more.

Features

  • Browse a curated catalog of popular audio apps
  • Install, remove or purge applications with one click
  • View real-time status (installed/not-installed)
  • Launch multiple apps simultaneously
  • Add, edit or remove custom applications to suit your workflow
  • Organized by category (DAW, Editor, Server, Synthesizer, etc.)
  • Built-in help & documentation panel
  • Config files stored in ~/.pystudiomusic for easy backup

Screenshots

Main Window Add Custom App
Manage Apps tab Add App tab
Status & Launch Help Panel
Status tab Help tab

Requirements

  • Debian 11+ or Ubuntu 20.04+
  • Python 3.8 or higher
  • GTK 3 (gir1.2-gtk-3.0)
  • PyGObject for Python 3 (python3-gi, python3-gi-cairo)

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/PyStudioMusic.git
cd PyStudioMusic

  2. Install system dependencies:

    sudo apt update
sudo apt install -y python3-gi python3-gi-cairo gir1.2-gtk-3.0

  3. Make the main script executable:

    chmod +x PyStudioMusic.py

  4. (Optional) Install a desktop entry for easy launching:

    sudo cp data/PyStudioMusic.desktop /usr/share/applications/
update-desktop-database

Usage

Run the application from a terminal or via your desktop menu:

./PyStudioMusic.py

Or, if you installed the desktop entry:

  • Search for PyStudioMusic in your applications menu and launch.

Configuration

All user data and custom entries are stored under:

~/.pystudiomusic/
└── apps.custom      # Custom app definitions

You can back up or edit these files by hand if needed. The GUI will reload them on next start.

Custom Applications

  1. Go to the Add App section in the side menu.
  2. Fill in:
    • Unique ID: machine-friendly identifier
    • Name: display name
    • Category: select from the dropdown
    • Description: short summary
    • APT Package: Debian package name
    • Launch Command: the shell command to start the app
  3. Click Add to Catalog.
  4. The new entry appears in Manage Apps (restart the app if necessary).

Contributing

Contributions are very welcome! Please:

  1. Fork the repository
  2. Create a feature branch: 
    git checkout -b feature/YourFeatureName
  3. Commit your changes and push: 
    git commit -m "Add some feature"
git push origin feature/YourFeatureName
  4. Open a Pull Request describing your work.

Please follow the existing code style and include appropriate comments and tests.

License

This project is licensed under the GPLv3. See the LICENSE file for details.

Acknowledgments

  • Thanks to the open-source Linux audio community for maintaining amazing tools
  • Icons by GNOME Icon Library
  • Inspired by the original StudioBand shell script by Luca Bocaletto

Clone this wiki locally