semvec/pypi-packages huggingface dataset:
uclip 0.1.4
Command Line Utility to upload clipboard images to B2 buckets
License: MIT
Requires Python: >=3.7.2,<3.12
Keywords: upload,image,b2,clipboard

## UClip - Clipboard image uploader

[![Build](https://github.com/ionite34/uclip/actions/workflows/build.yml/badge.svg)](https://github.com/ionite34/uclip/actions/workflows/build.yml)
[![codecov](https://codecov.io/gh/ionite34/uclip/branch/main/graph/badge.svg?token=58XSRH3F26)](https://codecov.io/gh/ionite34/uclip)

![PyPI - Python Version](https://img.shields.io/pypi/pyversions/uclip)
[![PyPI version](https://badge.fury.io/py/uclip.svg)](https://pypi.org/project/uclip/)

### Upload clipboard images to [B2 buckets][4]

![](docs/demo.gif)

> After upload, the displayed URL is also copied to the clipboard.

### Install via pip or [pipx](https://github.com/pypa/pipx)
```shell
pipx install uclip
```

### Usage
#### 1. Upload clipboard image
```shell
> uclip
✅ https://img.example.org/screens/9felsH.jpg
```
#### 2. `-f` or `--file`: Upload file from path
```shell
> uclip -f /Documents/dog.webp
? Generate random file name? Otherwise use name from path. Yes
✅ https://cdn.ionite.io/img/ik8tZg.webp
```

#### 3. `-d` or `--delete`: Delete named file from bucket
```shell
> uclip -d 9felsH.jpg
🗑️ Deleted 9felsH.jpg
```

### Run `--config` to set up your B2 API Keys and URL
```shell
> uclip --config
? B2 Application ID: 0013770e41044120000000001
? B2 Application Key: **********************
? B2 Bucket Name: bucket-name
? B2 Upload Path in Bucket: /screenshots/
? Alternate URL: https://img.example.org/
? File Name Length: 6
```

### The OS Keychain Service is used for secure API credential storage
> The keychain can be set to always allow, or via biometric authentication by Touch ID or Windows Hello.

| Windows                | MacOS         | Ubuntu LTS 20.04    |
|------------------------|---------------|---------------------|
| [Credential locker][1] | [Keychain][2] | [Secret Service][3] |

[1]: https://docs.microsoft.com/en-us/windows/uwp/security/credential-locker
[2]: https://developer.apple.com/documentation/security/certificate_key_and_trust_services/keys/storing_keys_in_the_keychain
[3]: https://specifications.freedesktop.org/secret-service/latest/
[4]: https://www.backblaze.com/b2/cloud-storage.html