uniclip 0.2.0

Description:

uniclip 0.2.0

Uniclip
Uniclip is a clipboard synchronization tool that allows you to share clipboard content across multiple devices within a group. It provides an easy way to keep your clipboard in sync across different machines, making it perfect for users who frequently work with multiple computers or collaborate in teams.
Current version: 0.2.0

:warning: Security Warning: The server has access to all the clipboard data you ever send to it. Make sure you trust the server. Also, all connections are currently unencrypted. Please be aware of these security implications.

Features

Easily deploy server with docker
Cross-device clipboard synchronization
Support for both headless and GUI environments
NeoVim support with a single Lua file (that calls curl)

Quick start guide
Run the following to set up a docker server:
git clone https://github.com/renxida/uniclip
docker build -t uniclip-server .
docker run -p 8037:2547 --name uniclip-server uniclip-server

On your client, run:
pip install uniclip
uniclip client --server http://server.example.com:8037

For neovim support client, run
# ensure curl is installed
# if not, run `sudo apt install curl`
git clone https://github.com/renxida/uniclip
cd uniclip
cp ./uniclip.lua ~/.config/nvim/lua
cat <<- EOF > ~/.config/nvim/init.lua

local uniclip = require('uniclip')
uniclip.setup()

EOF
mkdir -p ~/.config/uniclip

cat <<-EOF > ~/.config/uniclip/config.yaml
# Unique identifier for the group of devices that will share the clipboard
group_id: example-group
# Full address of the Uniclip server, including protocol and port
server_address: http://server.example.com:8037
# Set to true to force headless mode (useful for servers without a GUI)
headless: false
EOF

echo Try yanking something with neovim now

Installation
You can install Uniclip using pip:
pip install uniclip

Usage
Client Mode
To run Uniclip in client mode:
uniclip client --group <your_group_id> --server <server_address>

Optional arguments:

--headless: Force headless mode for the client

Example:
uniclip client --group myteam --server http://uniclip-server.example.com:2547

Server Mode
To run Uniclip in server mode:
uniclip server

Configuration
Uniclip uses a configuration file located at ~/.config/uniclip/config.yaml. You can set default values for the group ID, server address, and headless mode in this file.
Example configuration:
group_id: myteam
server_address: http://uniclip-server.example.com:2547
headless: false

Development
To set up the development environment:


Clone the repository:
git clone https://github.com/renxida/uniclip.git
cd uniclip



Create and activate a virtual environment:
python -m venv venv
source venv/bin/activate # On Windows, use `venv\Scripts\activate`



Install the package in editable mode:
pip install -e .



Run tests (assuming you have a tests directory with test files):
python -m unittest discover tests



Continuous Integration and Deployment
This project uses GitHub Actions for continuous integration and deployment. We follow semantic versioning (SemVer) for version numbers.
Creating a New Release
To create a new release:

Go to the "Actions" tab in your GitHub repository.
Select the "Release" workflow.
Click "Run workflow".
Choose the type of release:

patch: for backwards-compatible bug fixes
minor: for new backwards-compatible features
major: for changes that break backward compatibility


Click "Run workflow".

This will automatically:

Determine the next version number based on the current version and the type of release
Update the version number in uniclip/__init__.py
Create a new commit with the version change
Push the commit to the repository
Create a new tag with the version number
Create a new GitHub release
Update the version number in this README

The publish workflow will then automatically trigger, building and publishing the new version to PyPI.
Note: Only maintainers with the necessary permissions can trigger this workflow and publish releases.
Automatic Publishing
When a new release is created (either manually or through the Release workflow), the Publish workflow automatically builds the package and publishes it to PyPI using the Trusted Publisher mechanism.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

Please ensure your code adheres to the project's coding standards and includes appropriate tests.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
Hi contributor! Your name goes here.
Support
If you encounter any problems or have any questions, please open an issue on GitHub.