omegaui / cliptopia

Cliptopia is a beautiful state-of-the-art clipboard management software for linux desktops that turns your simple clipboard into a full-fledged ⚡power house⚡
BSD 3-Clause "New" or "Revised" License
110 stars 2 forks source link
clipboard clipboard-manager clipboard-sync flutter-app flutter-linux lightweight linux power-systems power-tools

image.png

App Icon

Typing SVG
Flutter Java Linux Shell Script
Buy Me A Coffee
Cliptopia Daemon
License Slite

Cliptopia

Cliptopia is a state-of-the-art clipboard management software for the linux desktops that turns your simple clipboard into a full-fledged ⚡power house

Cliptopia watches not only your texts but also any emojis, colors, commands, web images, screenshots or any local file/directory that you copy and then, it provides a full-fledged powerful interface supporting advanced searching and filtering which even allows you to search any image that you have copied. This is just the tip of the features Cliptopia provides out of the box.

As the names goes Cliptopia, it is all about your clipboard, but in the sense of vast land which is full of features that provides you a clipboard experience in the best ever form out there.

Features

See The Daemon , to explore more features.

GNOME (Ubuntu)

This is for users who are running GNOME on Ubuntu in a wayland session (default session). Rather than using wl-clipboard, please enable force-xclip mode from cliptopia's settings to prevent encounter this issue.

daemon The Daemon

At the heart of Cliptopia lies the cliptopia-daemon which is responsible for watching your clipboard.

When you install Cliptopia, you can run it directly from the app launcher or by just executing cliptopia in your terminal or by pressing Super + V after you have created the clipboard shortcut. In any case, cliptopia will ask you to install the daemon ...

Either you can download/build it from source by yourself from its repo or you let cliptopia handle this for you. Yes, Cliptopia can itself download the daemon for you if you desire so.

Moving further, in any case, the daemon should be placed at /usr/bin so that cliptopia can manage it.

Cliptopia is compositor independent which means it works the same no matter you are on X11 or Wayland. On X11, xclip is used to watch the clipboard and on Wayland wl-clipboard is used.

On some distros, like Ubuntu with GNOME on Wayland, xclip still works because of an XWayland session, so, if you want you can force cliptopia to use xclip even on wayland also from its settings panel.

img.png

Please note that Cliptopia is in beta until a stable version releases.

Installation

Right now, you can install cliptopia from source or from .deb package in releases section.

Using GPM

gpm --install omegaui/cliptopia

Maunal Install

Before that you need the following commands available in your linux distribution ...

Yes, Cliptopia is written entirely using Flutter, thus, it compiles to native and delivers lightning fast performance as your other apps.

Installing Cliptopia is a very easy and fast process ...

git clone https://github.com/omegaui/cliptopia
cd cliptopia
./install-from-source.sh

Running the above commands in sequence will install cliptopia on your machine.

If you have already installed cliptopia, running the above commands will result in manually updating your installation.

Keyboard Shortcut

Then, you need to add a custom keyboard shortcut to invoke Cliptopia in Power Mode ... img.png

If you have installed Cliptopia from releases using the .deb package, then, change

cliptopia --silent --power

to

/usr/local/lib/Cliptopia/cliptopia --silent --power 

Modes

Cliptopia can be made to launch in three mode:

Injection: it refers to clicking on an clipboard element in the UI of Cliptopia to insert it in the last focussed field.

Normal Mode

Silent Mode

Power Mode

There is a very valid reason Power Mode is designed to not update in real time, as we know, Super + V combination can be used to bring the Power Mode into effect, it is designed to be used occasionally when you require to find an item that you copied earlier and in cases, where you need to do this quickly.

So, for the Power Mode to get ready in an instant, a single read of the cache is performed to deliver the fastest possible performance on your system, thus, preventing the real time updates as there is no watching of the cache being maintained by the daemon.

That's why power mode does not update in realtime.

But, We do not stop here, actually the Power Mode can be made to update in real time, by using the --update flag. Work on this is currently under development.

Updates

Cliptopia will have a built-in update system, so, when a new release arrives, your installation will automatically notify you about it.

Uninstallation

Cliptopia will even offer an in-app uninstall feature to uninstall cliptopia from your system in case you want a fresh install.

Screenshot Gallery

image.png

image.png

Screenshot from 2023-12-10 19-43-06.png

Screenshot from 2023-12-10 19-57-50.png Screenshot from 2023-12-10 19-58-00.png

Screenshot from 2023-12-10 19-58-41.png Screenshot from 2023-12-10 19-58-34.png

image.png

Walkthrough

https://github.com/omegaui/cliptopia/assets/73544069/c0a143b8-63fa-4acf-8075-eee01808be70