DebIDE

DebIDE is a standalone desktop IDE tailored for Debian packaging workflows. It combines a project-aware file explorer, editor, Debian task runner, and scaffolding helpers in a single window.

Highlights

• Debian-first task recipes for lintian, debuild, dpkg-buildpackage, uscan, and sbuild
• Split-pane desktop layout: files, editor, task details, and live console output
• Project-level task configuration via .debide.yml, including task-specific environment variables
• One-click Debian packaging skeleton generator (Ctrl+N or debide scaffold)
• Optional autosave before task execution (autosave: true)

Requirements

• Python >= 3.10
• A graphical desktop session (X11/Wayland) for the GUI window
• Debian tooling installed for tasks you plan to run (lintian, devscripts, sbuild, etc.)

Quick Start

python -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -e .
debide .

Usage

• Browse project files in the left tree and double-click a file to open it.
• Edit in the main editor pane and save with Ctrl+S.
• Use Ctrl+Alt+S to save as a new file path.
• Use Ctrl+Shift+O to switch the workspace directory.
• Select Debian tasks from the task list and run with Ctrl+R.
• Watch task output stream live in the console pane.
• Scaffold a new debian/ directory with Ctrl+N.

Command-Line Interface

• debide [workspace] - launch the desktop IDE for the workspace directory (defaults to .).
• debide --config path/to/.debide.yml - start with an explicit config file.
• debide scaffold <name> [--version X] [--maintainer-name "Jane Doe"] [...] - generate Debian packaging files without launching the GUI.

Configuration

Create .debide.yml in your workspace:

autosave: true
default_task: debuild
tasks:
  - name: pbuilder
    command: pdebuild --use-pdebuild-internal
    description: Build inside a pbuilder chroot
    working_dir: debian
    env:
      DEBUILD_DPKG_BUILDPACKAGE_OPTS: "-us -uc"

Task definitions here extend or override built-in defaults.

Project Layout

• debide/desktop.py - standalone desktop app orchestration
• debide/tasks.py - task models and validation
• debide/config.py - configuration loader and merger
• debide/scaffold.py - Debian skeleton generator
• docs/ARCHITECTURE.md - architectural notes

License

Unlicense License. See LICENSE for full text.