clipman

✨ Clipman

Python3 module for working with clipboard. Created because pyperclip is discontinued.

Mostly made for ✨ YTCON

📘 Features:

• Easy use and simple architecture by KISS
• User-friendly
• No additional modules
• Supports many engines
• We use PyLint and we comment all our code
• Active development
• Just good dev 😇

👽 Using

import clipman
clipman.init() # Just initialize module

# Set text to clipboard
clipman.set("test")

# Get text from clipboard. So simple!:)
print(clipman.get())
Out: 'test'

Also you can use clipman.copy("ytcon") and clipman.paste() as from pyperclip!:)

Catching errors

• If you want to catch all errors from the module, use clipman.exceptions.ClipmanBaseException:

import clipman
try:
  clipman.init()
  print(clipman.paste())
except clipman.exceptions.ClipmanBaseException as e:
  print(e)

• And if you want to catch specific module error, use its name.

🚀 Install

Clipman is avalible on PyPI - https://pypi.org/project/clipman/

Install it as pip package

pip3 install clipman

🔌 Support

•‎ 🟩 Linux - FULL SUPPORT, native in KDE. In other cases, some additional dependencies are required

•‎ 🟩 Android - FULL SUPPORT in Termux, some additional deps needed too

•‎ 🟩 BSD Systems - Works on FreeBSD / GhostBSD and OpenBSD / FuguIta, deps same as Linux

•‎ 🟩 Windows - Works natively

•‎ 🟩 MacOS - Works on macOS HighSierra 10.13

📙 Additional deps

Unstead zypper you need to use system package manager: pkg, apt, dnf, pacman, etc

- = - = -

🐧 On Linux/BSD - ▶️ KDE (any display server)

• Native support. No additional dependencies are needed.

The only minimum requirement is dbus, and an dbus-next module, which will install with clipman as dependency

KDE Plasma 5 and KDE Plasma 6 is supported

- = - = -

🐧 On Linux/BSD - X11

• Install xsel or xclip package

Example: sudo zypper install xsel OR sudo zypper install xclip

- = - = -

🐧 On Linux/BSD - Wayland

• Install wl-clipboard package

Example: sudo zypper install wl-clipboard

- = - = -

🐸 On Android

Clipboard works only in Termux. And you need install additional deps in it.

• Install Termux:API from F-Droid
• Run pkg install termux-api
• Check it - run termux-clipboard-get

License

This code is under Mozilla Public License Version 2.0.

Contribution / Issues

📕 [!!] If you encouter an error, please read the error text very closely. The module is specially written so that errors give you a complete answer even if you a lamer

• 🥼 Pull requests are welcome!
• 🌈 Feel free to write Issues! The developer can answer you in the following languages: Ukrainian, English, Russian.
• Don't forget to attach version (pip3 show clipman) and error text with clipman.init(debug=True) :)
• ⏩ To speed up the process write to maintainer