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.3.0.tar.gz (18.9 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.3.0-py3-none-any.whl (18.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: clipman-3.3.0.tar.gz
  • Upload date:
  • Size: 18.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.5

File hashes

Hashes for clipman-3.3.0.tar.gz
Algorithm Hash digest
SHA256 878d19665ea12b6fbea0942bdae289794f8b69ef4333449ae4eab6ef11bcf3a6
MD5 b8b4bc3911a379b91a23be4616843c90
BLAKE2b-256 1b7c33dd46ed33a60c9005b3f2680b08a4482ff256c399010b1e2049cb8010c9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: clipman-3.3.0-py3-none-any.whl
  • Upload date:
  • Size: 18.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.5

File hashes

Hashes for clipman-3.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 93bf5f464d85d18d468bcd400bc3f15e7be286771447698a2e30d2c6c4b2480d
MD5 f00bbcb7be0ca59f88ebc3577f60c809
BLAKE2b-256 ef145834d0ba95f32f3536af5ef5354fe16a9a1956218e98ef70a01eed898f56

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