Skip to main content

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

Project description

✨ Clipman

License: Mozilla Public License 2.0 linting: pylint maintainer: NikitaBeloglazov

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.

It seems that all dependencies are listed below are already installed by default in all KDE distributions

The only minimum requirement is dbus, klipper (which is now built-in into KDE), and an dbus-python

🐧 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clipman-3.2.3.tar.gz (18.3 kB view hashes)

Uploaded Source

Built Distribution

clipman-3.2.3-py3-none-any.whl (17.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page