Skip to content

Release v0.1.4

Latest
Latest
Compare
Choose a tag to compare
@github-actions github-actions released this 20 May 14:53
· 2 commits to main since this release
v0.1.4
3c98e7e

🎉 Clipse GUI v0.1.4

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/d7omdev/clipse-gui.git
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

  • docs(readme): document compact mode and add screenshot
  • ci(release): improve release workflow with changelog and enhanced description
  • feat(ui): add compact mode for clipboard history 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.1.3...v0.1.4

Assets 2
Loading