PyLive

PyLive is a lightweight Python live-coding IDE built with GTK4, GtkSourceView, and VTE. It provides a compact editor, integrated terminal, and simple controls for rapid Python development.

---

Quick links

• Built package (latest): /home/user/Desktop/pylive_0.1.0-3_amd64.deb

---

Build (developer)

Requirements: GTK4, GtkSourceView-5, libvte-2.91-gtk4, gcc, make, debhelper (for packaging).

1. Install build deps (Debian/Ubuntu):

   sudo apt-get install build-essential debhelper libgtk-4-dev libgtksourceview-5-dev libvte-2.91-dev

2. Build the binary:

   make

---

Packaging

A Debian package is produced with:

dpkg-buildpackage -us -uc -b

Artifacts will be placed in the parent directory (e.g. /home/regan/Desktop/) as pylive_<version>_amd64.deb and a debug package pylive-dbgsym_<version>_amd64.ddeb.

---

Install (user)

To install the latest package on your Desktop:

sudo dpkg -i /home/regan/Desktop/pylive_0.1.0-3_amd64.deb

After installation, the application is available as PyLive in your desktop environment (menu entry: PyLive).

---

Files installed (examples)

• /usr/bin/PyLive — executable
• /usr/share/applications/pylive.desktop — desktop entry
• /usr/share/icons/hicolor/512x512/apps/pylive.png — icon
• /usr/share/man/man1/pylive.1.gz — manual page

---

Usage

Run from terminal or via application launcher:

   PyLive

Run from terminal 🔧

You can start PyLive directly from a shell:

• Run the installed system binary:

  PyLive

• Or run the built binary in the project directory (before installing):

  ./PyLive

You can pass standard environment or wrapper commands as needed (for example, PYTHONPATH or GDK_SCALE), e.g.: GDK_SCALE=1 PyLive.

---

Uninstalling the package safely ❌

To remove the package installed from the .deb:

• Remove while keeping config files:

  sudo apt remove pylive

• Remove and purge configuration files (recommended if you want a clean removal):

  sudo apt purge pylive

• If you installed via dpkg and want to purge:

  sudo dpkg -r pylive # remove sudo dpkg -P pylive # purge (remove + config files)

After uninstalling, you may want to run:

  sudo apt autoremove  # remove unused dependencies

Note: These commands will remove the installed files under /usr (binary, desktop entry, icon, and manpage).

---

Cleaning build and packaging files 🧹

To clean local build artifacts and package files created during packaging:

• Remove compiled objects and built program:

  make clean

• Remove generated Debian artifacts from the parent directory (where dpkg-buildpackage places them):

  rm -f ../pylive_*.deb ../pylive_*.changes ../pylive_*.buildinfo ../pylive-dbgsym_*.ddeb

• Clean Debian helper build state:

  dh clean (run inside the project or via debian/rules clean)

These steps help keep your working tree tidy and prevent accidentally committing build artifacts. ---

Contributing

Patches and issues are welcome. Open an issue or submit a pull request on the project repository.

---

License

See debian/copyright and project files for license details.