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

⚠️ 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:

1. Clone the repository:

   git clone https://github.com/renxida/uniclip.git
   cd uniclip

2. Create and activate a virtual environment:

   python -m venv venv
   source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

3. Install the package in editable mode:

   pip install -e .

4. 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:

1. Go to the "Actions" tab in your GitHub repository.
2. Select the "Release" workflow.
3. Click "Run workflow".
4. Choose the type of release:
   • patch: for backwards-compatible bug fixes
   • minor: for new backwards-compatible features
   • major: for changes that break backward compatibility
5. 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.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. 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.