The Daemon

  • You have already seen the features on the frontend in the introductory doc of  Cliptopia .
  • Apart from providing a UI, Cliptopia can even work without it.
  • Cliptopia's Daemon is the heart of Cliptopia. This daemon is the actual engine working in the background that watches your clipboard, organizes history, optimizes items, removes corrupted or requested items, and maintains the clipboard state on system restart.

Thus, you can even just install the daemon independently of Cliptopia, and can even record your clipboard without needing the GUI part. The daemon is totally configurable by editing human-friendly config files that are stored in JSON format.


Usage

  • cliptopia-daemon once installed, gets system wide available and can be made to run from the terminal.
It is installed at /usr/bin/cliptopia-daemon
By Default, the Cliptopia (GUI) will automatically start it, once it is installed. Here's the shell usage manual.
Usage: cliptopia-daemon [OPTIONS]
where OPTIONS could be one of these:

	--start                    Start Daemon
	--stop                     Stop Daemon
	--status                   Show Daemon Status
	--cache-size               Show Cache Size in MB
	--enable-incognito-mode    Pause clipboard watching
	--disable-incognito-mode   Continue clipboard watching
	--restart                  Stop and Restart Daemon
	--reset-cache              Stops the Daemon and clears the clipboard cache (not-recommended)
	--version                  Prints program version
	--help                     Prints this help message

and optionally:
	--debug                    Enable printing logs to the terminal (should only be used when debugging)

examples:
	cliptopia-daemon --start --debug  # to start the daemon in debug mode
	cliptopia-daemon --stop           # to stop any running instance of the daemon
	cliptopia-daemon --status         # to check if the daemon is alive or stopped
	cliptopia-daemon --restart        # to stop the running instance and restart the daemon

Cache Management

Unlike other clipboard managers, cliptopia works uniquely. It allows for a more flexible approach:
  • You can set the cache limit in storage metrics, for example:
  • 100 MB, 20 KB
  • or even 1 GB
  • The supported units are KB, MB, and GB.
  • The supported value is in whole number format.
  • Decimals are not allowed.

Here's daemon-config.json ...
{
  "limit-cache": true,
  "cache-size": 100,
  "unit": "MB",
  "maintain-state": false
}
All of the cliptopia configs are stored in ~/.config/cliptopia.

All these configs are automatically maintained by the daemon and the Cliptopia GUI. In any case, you can even manually override these configs.

That's it. Thank you for reading Blue Heart.