Skip to content
patrick-hudsonPublic

About

A keyboard-first clipboard manager for Linux/X11 with a Jumpcut-style picker, tray history, searchable archive, and backups.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Jumpkut — your clipboard, a shortcut away

Tests Linux packages Latest release MIT license X11 or KDE Plasma Wayland Python 3.10 or newer

A small, keyboard-first clipboard manager for Linux.
Copy text. Press Alt+C. Find the clipping you need. Keep moving.

Install · How it works · Screenshots · Preferences · Changelog

Jumpkut brings the quick, single-clipping picker of Jumpcut to Linux, with a scissors tray icon, a searchable history browser, and portable backups. It is a native GTK 3 app written in Python.

Runs on X11 desktops and on KDE Plasma 6 Wayland (details). Other Wayland desktops are not supported yet. Jumpkut records text, including Unicode and multiline content; images and files are not recorded.

How it works

  1. Copy text in any app. Jumpkut saves it in the background.
  2. Press Alt+C and keep Alt held. The picker starts at the newest clipping, #1.
  3. Browse with ↑ / ↓ or press C again to cycle.
  4. Release Alt to select and paste into your previous app. Esc cancels.

Prefer to choose without holding a key? Enable Keep history open until Enter in Preferences.

A place for every clipping What you get
Quick picker A Jumpcut-style bezel with one preview at a time; the newest 30 clippings by default.
System tray The newest 10 clippings, plus Full History, Preferences, Pause Recording, backups, and Quit.
Full History Every saved clipping, with search, full previews, copying, and deletion.
Your preferences A configurable shortcut, independent optional quick/tray limits, startup, and paste behavior.
Backups Export the complete archive to JSON; restore and merge without losing existing clippings.
Background launch One jumpkut command, a desktop app-menu entry, and optional startup at login.

Screenshots

These are real screenshots of Jumpkut 0.4.0, using demo clippings.

Quick picker

Alt+C quick picker, showing the newest clipping numbered 1
System tray

Tray menu with ten recent clippings and normal app options

Full History — search, read, copy, and organize the complete archive

Searchable Full History browser with a clipping list and complete text preview

Preferences & backups

Preferences with Alt+C, independent default limits of 30 and 10, startup, and backup controls
Version information

About Jumpkut showing version 0.4.0 and the scissors icon

Installation

Download an installer from the latest release. All formats run on an X11 session or KDE Plasma Wayland, and support the same clipboard history, preferences, and backups.

Format Use it on What is included
.deb Linux Mint, Ubuntu, Debian with Python 3.10+ System-wide command, application-menu entry, and scissors icon; apt installs dependencies.
.rpm Fedora with Python 3.10+ System-wide command, application-menu entry, and scissors icon; dnf installs dependencies.
.AppImage x86_64 Linux with glibc 2.35+ Portable bundle containing Python, GTK, and the application's dependencies.

Debian, Ubuntu & Linux Mint

From the directory containing your downloaded .deb:

sudo apt install ./jumpkut_*_all.deb
jumpkut

Fedora

From the directory containing your downloaded .rpm:

sudo dnf install ./jumpkut-*.noarch.rpm
jumpkut

Both native packages add Jumpkut to your desktop's application menu. Open it there to browse Full History. Installing a later package updates the app and preserves your saved history and preferences.

Portable AppImage

Save the AppImage somewhere permanent, such as ~/Applications, then make it executable and run it:

chmod +x Jumpkut-*-x86_64.AppImage
./Jumpkut-*-x86_64.AppImage

It starts in the background. Append --history to open Full History or --preferences to configure it. Enable Run at startup after placing the file in its permanent location. If you move or rename the AppImage, disable and re-enable startup from its new location.

If your desktop cannot mount AppImages with FUSE, use the runtime's extraction mode:

APPIMAGE_EXTRACT_AND_RUN=1 ./Jumpkut-*-x86_64.AppImage

Release downloads include SHA256SUMS. Put it beside the downloaded packages and run sha256sum --check --ignore-missing SHA256SUMS to verify them. Source .zip and .tar.gz archives are also available on each release page.

KDE Plasma Wayland

On Plasma 6 Wayland (for example Fedora KDE), Jumpkut runs its windows and tray icon through XWayland and uses KDE session services for the parts Wayland keeps private:

  • Shortcut — Alt+C is registered with KDE's global shortcut service. It also appears in System Settings → Keyboard → Shortcuts → Jumpkut; change it in Jumpkut's Preferences.
  • Clipboard — wl-paste --watch records copies from every app, and wl-copy sets the chosen clipping. It needs wl-clipboard 2.3 or newer (sudo dnf install wl-clipboard). Copies that carry the KDE password-manager hint (x-kde-passwordManagerHint, set by KeePassXC and similar apps) are skipped; other password copies are recorded like any text.
  • Paste automatically — KDE asks once for permission to type the paste shortcut (Remote control requested). Allow it and keep Allow restoring on future sessions checked. Afterwards KDE shows a short exercising remote control privileges notice once each time Jumpkut starts (usually once per sign-in); turning Paste automatically off avoids it. If you decline, Jumpkut still copies the clipping and you paste it yourself: Ctrl+V, or Ctrl+Shift+V (or your terminal's paste shortcut) in terminals such as Konsole and Ghostty. To ask again, turn Paste automatically off and on in Preferences.

python-xlib is only needed for X11 sessions.

Install from source

On Linux Mint, Ubuntu, or Debian, install the system dependencies, then clone and install Jumpkut for your user:

sudo apt install git python3-gi gir1.2-gtk-3.0 python3-xlib librsvg2-common
git clone https://github.com/patrick-hudson/jumpkut.git
cd jumpkut
./install.py
jumpkut

Python 3.10 or newer is required. Only the dependency installation needs sudo; run the Jumpkut installer as your normal user.

Plain jumpkut starts in the background and returns immediately. The app stays in the tray after you close the terminal. You can also open Jumpkut from your desktop's application menu to show Full History.

If your shell cannot find the command, add the user bin directory to your shell's PATH:

export PATH="$HOME/.local/bin:$PATH"

Add that line to your shell's startup file to keep it across terminals. Enable Run at startup in Preferences to start Jumpkut when you sign in.

Linux Mint Cinnamon supports the tray protocol Jumpkut uses. Other desktops need support for legacy tray icons; GNOME may need a tray extension.

Installation paths and running from source

The installer creates:

Item Location
Command ~/.local/bin/jumpkut
Application ~/.local/share/jumpkut/app/
App-menu entry ~/.local/share/applications/jumpkut.desktop
Scissors icon ~/.local/share/icons/hicolor/scalable/apps/jumpkut.svg

Use ./install.py --prefix /some/directory for a custom installation base. You can run from a source checkout with ./run.py without installing the launcher.

Keyboard controls

In the quick picker Action
Alt+C Resume the last selected clipping, or start at the newest after a new copy; repeated C cycles while Alt is held.
↑ / ↓ Browse recent clippings.
Release Alt Select and automatically paste, with default preferences.
Enter Select in sticky mode or when opened with --show.
Home / End Jump to the newest / oldest clipping in the picker.
Delete Delete the selected clipping from saved history.
Esc Cancel.

In Full History, use arrows and Page Up / Page Down to browse, Enter or double-click to copy, and Ctrl+F to search. Copying leaves the browser open and preserves history order; paste into your other app when ready.

Automatic paste uses Ctrl+V, or Ctrl+Shift+V for recognized terminal windows. You can disable it in Preferences and paste the selected clipboard text yourself.

Preferences

Click the scissors tray icon and choose Preferences.

Setting Default Customize it
Keyboard shortcut Alt+C Click the shortcut button and press a new combination.
Quick picker length 30 Check Custom quick history length, then choose 1–10,000.
Tray menu length 10 Check Custom tray history length, then choose 1–10,000.
Full History All saved clippings Delete individual entries or use Clear History.
Run at startup Off Enable it to start at login.
Automatic paste On Disable it to copy selections without pasting.
Resume last selection On Reopen the last selected clipping until you copy something new. Disable it to always start at #1.
Keep picker open until Enter Off Enable it to choose after releasing the shortcut.

The two custom-length checkboxes start unchecked. Unchecking one restores that view's default and remembers its custom value for later. Changing either limit never removes older clippings from Full History.

A shortcut already in use produces an error. Changes take effect when you save.

During the current session, the quick picker remembers the clipping you last selected from the picker, tray, or Full History. Selecting through Jumpkut keeps the original copy order and does not count as a new copy. Browsing and canceling leaves that selection unchanged. Copying text in another app resets the picker to #1, including copying text already in the archive. If the remembered clipping is deleted or outside the quick history limit, the picker starts at #1. Restarting Jumpkut also starts at #1.

History & backups

Use Back Up History… in the tray, Preferences, or Full History to export the complete archive to a portable JSON file. Restore Backup… merges a backup with your existing archive, removes duplicate text, and retains older entries beyond the quick and tray limits.

History keeps all unique clippings until you delete them or clear it. Repeated copies move an existing clipping to the front. Exact whitespace and text are preserved; empty or whitespace-only copies are ignored.

History and backups contain plain text. Clippings explicitly marked sensitive by supported password managers are skipped; ordinary clipboard text is stored as copied.

Saved data Default location
Preferences ~/.config/jumpkut/config.json
History ~/.local/share/jumpkut/history.json
Startup entry ~/.config/autostart/jumpkut.desktop
Background log ~/.local/state/jumpkut/jumpkut.log

Jumpkut respects XDG_CONFIG_HOME, XDG_DATA_HOME, and XDG_STATE_HOME. Clearing history keeps exported backups and leaves the current system clipboard unchanged.

Commands

jumpkut                # Start in the background
jumpkut --show         # Open the quick picker
jumpkut --history      # Open Full History
jumpkut --preferences  # Open Preferences
jumpkut --about        # Show version and credits
jumpkut --quit         # Quit the running instance
jumpkut --version      # Print the installed version
jumpkut --daemon       # Run attached to the terminal for debugging

--background explicitly selects the default background behavior. One instance runs per desktop session; commands are forwarded to it.

Updating

For .deb and .rpm installations, quit the running app, install the newer downloaded package with the command above, and start Jumpkut again. For AppImage, quit the app, replace the old file, and run the new one. Re-enable startup if its filename changed. Saved history and preferences live in your XDG directories and are shared between installation formats.

If you previously used ./install.py, its ~/.local/bin/jumpkut command and ~/.local/share/applications/jumpkut.desktop menu entry may take precedence over the native package. Quit the old app, rename those two files, and start /usr/bin/jumpkut. Then disable and re-enable Run at startup in the new app. This does not require removing any saved history.

From your source checkout:

git pull --ff-only
./install.py
jumpkut --quit
jumpkut

Reinstalling preserves saved history, preferences, and backups. Restart a running instance after updating so it loads the new code. Standard installs persist history to disk; if you disabled persistence in the configuration file, back up the in-memory history before quitting.

Older preferences using the previous default of 200 move to the new 30/10 defaults. A saved quick length of 30 uses the unchecked default; other custom quick lengths stay enabled. Entries removed by an older release can be recovered only from a backup containing them.

Development

Use the system Python so GTK and PyGObject are available:

/usr/bin/python3 -m unittest discover -s tests -v

Run the native desktop integration tests separately:

sudo apt install xvfb metacity dbus-x11
./scripts/test-desktop.sh

The native runner uses a disposable X11 display, a private session bus, and temporary history and preferences. It does not use your live clipboard. GitHub Actions runs both suites.

The Linux packages workflow builds all three packages on pushes and pull requests; you can also run it manually. CI tests the native package and AppImage after packaging, then saves the files as an Actions artifact. Pushing a matching vX.Y.Z tag publishes the tested installers and checksums as a GitHub release.

Read CONTRIBUTING.md for development and releases, CHANGELOG.md for release notes, and validation notes for test coverage.

License & credits

MIT. Inspired by Jumpcut for macOS. Jumpkut is an independent project and uses its own GTK interface, clipboard implementation, and scissors artwork.

About

A keyboard-first clipboard manager for Linux/X11 with a Jumpcut-style picker, tray history, searchable archive, and backups.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages