Release v0.9.0

🎉 Clipse GUI v0.9.0

A GTK3 graphical user interface for the excellent
clipse.

📦 Install

• Arch Linux: yay -S clipse-gui (AUR)
• Other distros: download the wheel below and run
  pip install clipse_gui-*.whl. Requires system python-gobject,
  gtk3, wl-clipboard, and xdotool or wtype.
• From source: download the .tar.gz sdist and run pip install,
  or clone and use python -m build + python -m installer.

⚠️ The Nuitka onefile and AppImage are no longer published — they
shipped a frozen gi that asserted against the user's live glib2
and crashed on rolling distros (issues #13, #14). The wheel + sdist
install path keeps gi in lockstep with the user's system Python.

📝 Changelog

• chore: bump version to 0.9.0
• Merge pull request #16 from d7omdev/dev
• ci: use system python3 for tests to access gi bindings
• ci: add lint + test workflow for PRs and pushes
• test: add pytest suite and 'just test' recipe
• feat(compact): launch window at cursor position via gtk-layer-shell
• refactor(keyboard): replace if-chain with dispatch table
• Merge branch 'main' into dev

Release v0.8.0

🎉 Clipse GUI v0.8.0

A GTK3 graphical user interface for the excellent
clipse.

📦 Install

• Arch Linux: yay -S clipse-gui (AUR)
• Other distros: download the wheel below and run
  pip install clipse_gui-*.whl. Requires system python-gobject,
  gtk3, wl-clipboard, and xdotool or wtype.
• From source: download the .tar.gz sdist and run pip install,
  or clone and use python -m build + python -m installer.

⚠️ The Nuitka onefile and AppImage are no longer published — they
shipped a frozen gi that asserted against the user's live glib2
and crashed on rolling distros (issues #13, #14). The wheel + sdist
install path keeps gi in lockstep with the user's system Python.

📝 Changelog

• build(release): drop Nuitka workflow, ship wheel + sdist instead
• Merge pull request #15 from d7omdev/feat/pyproject-installer
• feat(ui): polish header, settings appearance, and lifecycle handling
• refactor: split controller.py and ui_components.py into focused modules
• build(justfile): switch canonical build/install recipes to wheel + python-installer
• build: adopt SPDX license expression in pyproject.toml
• build: migrate from Nuitka onefile to pyproject.toml + python-installer
• ci: remove unsupported --linux-onefile-compression flag from Nuitka 2.x
• ci: call nuitka directly instead of via just
• fix: workflow
• feat: rich content previews, link handling, and startup optimizations
• feat: rich content previews, link handling, and startup optimizations
• fix(style): remove !important from CSS to fix GTK parsing error
• fix(style): remove notebook borders and fix border radius application
• feat(style): add Style tab with customizable border radius and colors
• feat(search): add search term highlighting in results
• fix(search): allow typing bound keys in search field
• build: fix Nuitka build system and update installation

Release v0.7.0

🎉 Clipse GUI v0.7.0

A GTK3 graphical user interface for the excellent
clipse.

📝 Changelog

• ci: remove unsupported --linux-onefile-compression flag from Nuitka 2.x
• ci: call nuitka directly instead of via just
• fix: workflow
• feat: rich content previews, link handling, and startup optimizations
• feat: rich content previews, link handling, and startup optimizations
• fix(style): remove !important from CSS to fix GTK parsing error
• fix(style): remove notebook borders and fix border radius application
• feat(style): add Style tab with customizable border radius and colors
• feat(search): add search term highlighting in results
• fix(search): allow typing bound keys in search field
• build: fix Nuitka build system and update installation

Release v0.6.0

🎉 Clipse GUI v0.6.0

A GTK3 graphical user interface for the excellent
clipse.

📝 Changelog

• ci: remove AUR update job from release workflow
• ci: add native ARM64 build using ubuntu-24.04-arm runner
• Merge branch 'dev'
• ci: fix stale workflow permissions
• Merge pull request #12 from d7omdev/dev
• ci: simplify release workflow and add AUR auto-update
• chore: bump version to v0.6.0
• feat(tray): add window restore and tray settings
• chore: fix linting and type checking errors
• fix(paste): improve reliability and add single-click support
• feat(build): add justfile with smart task runner

Release v0.5.0

🎉 Clipse GUI v0.5.0

A GTK3 graphical user interface for the excellent
clipse.

📝 Changelog

• ci: copy icon to AppDir root for appimagetool
• ci: remove macOS 13 (Intel) build, keep only macOS 15 (ARM64)
• ci: fix linuxdeploy-plugin-gtk download URL
• ci: use macos-15 for arm64 builds
• chore: add pre-commit hook and fix release workflow
• feat(ui): refresh list styling, animate pin icon, and improve help window layout

Release v0.4.0

🎉 Clipse GUI v0.4.0

A GTK3 graphical user interface for the excellent clipse.

📝 Changelog

• fix: switch to onefile build for proper PyGObject bundling
• fix: improve artifact detection in release workflow
• fix: update build workflow for GitHub Actions
• feat: add multi-select visual mode
• Refactor GitHub Actions release workflow
• Increase stale issue inactivity period to 30 days
• Add stale.yml to close inactive issues
• feat(gui): add minimize-to-tray support with tray icon and settings toggle

Release v0.3.2

🎉 Clipse GUI v0.3.2

A GTK3 graphical user interface for the excellent clipse command-line clipboard manager.

✨ Features

🎯 Core Functionality

• 📋 View text and image entries from clipboard history
• 🔍 Fuzzy search with instant results
• 📌 Pin important items
• 🖼️ Image support with previews
• 📋 Copy items back to system clipboard
• ⌨️ Keyboard shortcuts for power users

🎨 UI/UX

• 🎯 Compact mode for minimal footprint
• 🔄 Real-time updates
• 📱 Responsive and adaptive layout

⚡ Performance

• 🚀 Lazy loading for better performance
• 💾 Efficient memory usage
• 🔄 Incremental history loading
• 🎯 Optimized image handling

Installation

Installation

Dependencies

• Core:
  • Python 3 (>= 3.7 recommended)
  • GTK+ 3 libraries
  • PyGObject (Python bindings for GTK) - Install using your system's package manager (e.g., python-gobject on Arch/Fedora, python3-gi on Debian/Ubuntu).
• Clipboard Copying (Required):
  • Wayland: wl-copy (usually part of wl-clipboard)
  • X11: xclip
  • (The application attempts to use the appropriate tool based on your session type, but you can configure alternatives)
• Paste-on-Enter Feature (Optional):
  • Wayland: wtype
  • X11: xdotool
  • (These tools are only needed if you enable enter_to_paste = True in the configuration)

Arch Linux (AUR)

An AUR package is available: clipse-gui

# Using yay (or your preferred AUR helper)
yay -S clipse-gui

Manual Installation (Using Makefile)

1. Clone the repository:

   git clone https://github.com/YOUR_USERNAME/clipse-gui.git # Replace with actual repo URL
   cd clipse-gui

2. Install Dependencies: Ensure you have Python, GTK3, PyGObject, and the required clipboard/paste tools installed (see Dependencies above).
3. Build and Install: The Makefile uses Nuitka to create a distributable binary.

   # Install Nuitka if you don't have it
   # python -m pip install nuitka
   make install
   # This will likely require sudo privileges

   This command will:
   • Build the application using Nuitka (if not already built).
   • Copy the built application files to /usr/local/share/clipse-gui.
   • Create a symbolic link in /usr/local/bin/clipse-gui.
   • Install the application icon.
   • Install a .desktop file for application launchers.
4. Uninstall:

   make uninstall
   # This will likely require sudo privileges

Running from Source (Development / Testing)

1. Clone the repository (if not already done).
2. Install Dependencies (see above).
3. Run the script:

   python clipse-gui.py

   Or for debugging output:

   python clipse-gui.py --debug

🔧 Configuration

Configuration file: ~/.config/clipse-gui/settings.ini

📝 Changelog

• feat(gui): add minimize-to-tray support with tray icon and settings toggle

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Full Changelog: v0.3.1...v0.3.2

Release v0.3.1

🎉 Clipse GUI v0.3.1

A GTK3 graphical user interface for the excellent clipse command-line clipboard manager.

✨ Features

🎯 Core Functionality

• 📋 View text and image entries from clipboard history
• 🔍 Fuzzy search with instant results
• 📌 Pin important items
• 🖼️ Image support with previews
• 📋 Copy items back to system clipboard
• ⌨️ Keyboard shortcuts for power users

🎨 UI/UX

• 🎯 Compact mode for minimal footprint
• 🔄 Real-time updates
• 📱 Responsive and adaptive layout

⚡ Performance

• 🚀 Lazy loading for better performance
• 💾 Efficient memory usage
• 🔄 Incremental history loading
• 🎯 Optimized image handling

Installation

Installation

Dependencies

• Core:
  • Python 3 (>= 3.7 recommended)
  • GTK+ 3 libraries
  • PyGObject (Python bindings for GTK) - Install using your system's package manager (e.g., python-gobject on Arch/Fedora, python3-gi on Debian/Ubuntu).
• Clipboard Copying (Required):
  • Wayland: wl-copy (usually part of wl-clipboard)
  • X11: xclip
  • (The application attempts to use the appropriate tool based on your session type, but you can configure alternatives)
• Paste-on-Enter Feature (Optional):
  • Wayland: wtype
  • X11: xdotool
  • (These tools are only needed if you enable enter_to_paste = True in the configuration)

Arch Linux (AUR)

An AUR package is available: clipse-gui

# Using yay (or your preferred AUR helper)
yay -S clipse-gui

Manual Installation (Using Makefile)

1. Clone the repository:

   git clone https://github.com/YOUR_USERNAME/clipse-gui.git # Replace with actual repo URL
   cd clipse-gui

2. Install Dependencies: Ensure you have Python, GTK3, PyGObject, and the required clipboard/paste tools installed (see Dependencies above).
3. Build and Install: The Makefile uses Nuitka to create a distributable binary.

   # Install Nuitka if you don't have it
   # python -m pip install nuitka
   make install
   # This will likely require sudo privileges

   This command will:
   • Build the application using Nuitka (if not already built).
   • Copy the built application files to /usr/local/share/clipse-gui.
   • Create a symbolic link in /usr/local/bin/clipse-gui.
   • Install the application icon.
   • Install a .desktop file for application launchers.
4. Uninstall:

   make uninstall
   # This will likely require sudo privileges

Running from Source (Development / Testing)

1. Clone the repository (if not already done).
2. Install Dependencies (see above).
3. Run the script:

   python clipse-gui.py

   Or for debugging output:

   python clipse-gui.py --debug

🔧 Configuration

Configuration file: ~/.config/clipse-gui/settings.ini

📝 Changelog

• feat(settings): add "Enter to paste" toggle to settings window

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Full Changelog: v0.3.0...v0.3.1

Release v0.3.0

🎉 Clipse GUI v0.3.0

A GTK3 graphical user interface for the excellent clipse command-line clipboard manager.

✨ Features

🎯 Core Functionality

• 📋 View text and image entries from clipboard history
• 🔍 Fuzzy search with instant results
• 📌 Pin important items
• 🖼️ Image support with previews
• 📋 Copy items back to system clipboard
• ⌨️ Keyboard shortcuts for power users

🎨 UI/UX

• 🎯 Compact mode for minimal footprint
• 🔄 Real-time updates
• 📱 Responsive and adaptive layout

⚡ Performance

• 🚀 Lazy loading for better performance
• 💾 Efficient memory usage
• 🔄 Incremental history loading
• 🎯 Optimized image handling

Installation

Installation

Dependencies

• Core:
  • Python 3 (>= 3.7 recommended)
  • GTK+ 3 libraries
  • PyGObject (Python bindings for GTK) - Install using your system's package manager (e.g., python-gobject on Arch/Fedora, python3-gi on Debian/Ubuntu).
• Clipboard Copying (Required):
  • Wayland: wl-copy (usually part of wl-clipboard)
  • X11: xclip
  • (The application attempts to use the appropriate tool based on your session type, but you can configure alternatives)
• Paste-on-Enter Feature (Optional):
  • Wayland: wtype
  • X11: xdotool
  • (These tools are only needed if you enable enter_to_paste = True in the configuration)

Arch Linux (AUR)

An AUR package is available: clipse-gui

# Using yay (or your preferred AUR helper)
yay -S clipse-gui

Manual Installation (Using Makefile)

1. Clone the repository:

   git clone https://github.com/YOUR_USERNAME/clipse-gui.git # Replace with actual repo URL
   cd clipse-gui

2. Install Dependencies: Ensure you have Python, GTK3, PyGObject, and the required clipboard/paste tools installed (see Dependencies above).
3. Build and Install: The Makefile uses Nuitka to create a distributable binary.

   # Install Nuitka if you don't have it
   # python -m pip install nuitka
   make install
   # This will likely require sudo privileges

   This command will:
   • Build the application using Nuitka (if not already built).
   • Copy the built application files to /usr/local/share/clipse-gui.
   • Create a symbolic link in /usr/local/bin/clipse-gui.
   • Install the application icon.
   • Install a .desktop file for application launchers.
4. Uninstall:

   make uninstall
   # This will likely require sudo privileges

Running from Source (Development / Testing)

1. Clone the repository (if not already done).
2. Install Dependencies (see above).
3. Run the script:

   python clipse-gui.py

   Or for debugging output:

   python clipse-gui.py --debug

🔧 Configuration

Configuration file: ~/.config/clipse-gui/settings.ini

📝 Changelog

• Bump version to 0.3.0
• Add hover-to-select functionality
• Update README with new features
• Add hover-to-select feature
• feat(settings): add settings window and protect pinned items option
• feat: enhance preview window search bar and config handling

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Full Changelog: v0.2.0...v0.3.0

Release v0.2.0

🎉 Clipse GUI v0.2.0

A GTK3 graphical user interface for the excellent clipse command-line clipboard manager.

✨ Features

🎯 Core Functionality

• 📋 View text and image entries from clipboard history
• 🔍 Fuzzy search with instant results
• 📌 Pin important items
• 🖼️ Image support with previews
• 📋 Copy items back to system clipboard
• ⌨️ Keyboard shortcuts for power users

🎨 UI/UX

• 🎯 Compact mode for minimal footprint
• 🔄 Real-time updates
• 📱 Responsive and adaptive layout

⚡ Performance

• 🚀 Lazy loading for better performance
• 💾 Efficient memory usage
• 🔄 Incremental history loading
• 🎯 Optimized image handling

Installation

Installation

Dependencies

• Core:
  • Python 3 (>= 3.7 recommended)
  • GTK+ 3 libraries
  • PyGObject (Python bindings for GTK) - Install using your system's package manager (e.g., python-gobject on Arch/Fedora, python3-gi on Debian/Ubuntu).
• Clipboard Copying (Required):
  • Wayland: wl-copy (usually part of wl-clipboard)
  • X11: xclip
  • (The application attempts to use the appropriate tool based on your session type, but you can configure alternatives)
• Paste-on-Enter Feature (Optional):
  • Wayland: wtype
  • X11: xdotool
  • (These tools are only needed if you enable enter_to_paste = True in the configuration)

Arch Linux (AUR)

An AUR package is available: clipse-gui

# Using yay (or your preferred AUR helper)
yay -S clipse-gui

Manual Installation (Using Makefile)

1. Clone the repository:

   git clone https://github.com/YOUR_USERNAME/clipse-gui.git # Replace with actual repo URL
   cd clipse-gui

2. Install Dependencies: Ensure you have Python, GTK3, PyGObject, and the required clipboard/paste tools installed (see Dependencies above).
3. Build and Install: The Makefile uses Nuitka to create a distributable binary.

   # Install Nuitka if you don't have it
   # python -m pip install nuitka
   make install
   # This will likely require sudo privileges

   This command will:
   • Build the application using Nuitka (if not already built).
   • Copy the built application files to /usr/local/share/clipse-gui.
   • Create a symbolic link in /usr/local/bin/clipse-gui.
   • Install the application icon.
   • Install a .desktop file for application launchers.
4. Uninstall:

   make uninstall
   # This will likely require sudo privileges

Running from Source (Development / Testing)

1. Clone the repository (if not already done).
2. Install Dependencies (see above).
3. Run the script:

   python clipse-gui.py

   Or for debugging output:

   python clipse-gui.py --debug

🔧 Configuration

Configuration file: ~/.config/clipse-gui/settings.ini

📝 Changelog

• feat(ui): enhance compact mode and preview search experience
• feat(preview): add format and search actions to preview window
• chore(workflow): clean up release workflow and fix README details section

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Full Changelog: v0.1.4...v0.2.0