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.1.tar.gz (17.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

clipman-3.2.1-py3-none-any.whl (17.3 kB view details)

Uploaded Python 3

File details

Details for the file clipman-3.2.1.tar.gz.

File metadata

  • Download URL: clipman-3.2.1.tar.gz
  • Upload date:
  • Size: 17.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.2 CPython/3.11.8

File hashes

Hashes for clipman-3.2.1.tar.gz
Algorithm Hash digest
SHA256 7ed4fcbc2af4d4b819cacfe08d7ad8e0336f6ad87cf41705003d0b65af1ee95a
MD5 0fe13c971a98290330cc604b1bfecb30
BLAKE2b-256 92994ef051b2a5cc5e660f4e9c8e715fc4a93de19e89d57a0091c0ced8f2616d

See more details on using hashes here.

File details

Details for the file clipman-3.2.1-py3-none-any.whl.

File metadata

  • Download URL: clipman-3.2.1-py3-none-any.whl
  • Upload date:
  • Size: 17.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.2 CPython/3.11.8

File hashes

Hashes for clipman-3.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 fbd91e9967cbffe56244e10aae2b994f63fde28e8a4ee62175f114ae8bd0d6cb
MD5 233b20b514f56c923ad95aca4e62256f
BLAKE2b-256 d77dcc15e48ab978790f9fda61b948475a903970b53a498271eee13b438edb02

See more details on using hashes here.

Supported by

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