✨ Clipman
![maintainer: NikitaBeloglazov](https://img.shields.io/badge/Maintainer:_.%E2%80%A2%C2%B0%E2%97%8F%E2%9D%A4%EF%B8%8F%20NikitaBeloglazov%20Software%20Foundation%20%E2%9D%A4%EF%B8%8F%E2%97%8F%C2%B0%E2%80%A2.-informational?logoColor=white&style=for-the-badge&logo=github)
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
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