Skip to content

πŸ“‹ Python 3 module for working with clipboard. Created because pyperclip is discontinued. Mostly made for ✨ YTCON

License

Notifications You must be signed in to change notification settings

NikitaBeloglazov/clipman

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

71 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

✨ 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.

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

About

πŸ“‹ Python 3 module for working with clipboard. Created because pyperclip is discontinued. Mostly made for ✨ YTCON

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages