https://github.com/ionite34/uclip

Upload clipboard images to B2 buckets
https://github.com/ionite34/uclip

backblaze-b2 s3-bucket screenshot uploader

Last synced: about 2 months ago
JSON representation

Upload clipboard images to B2 buckets

• Host: GitHub
• URL: https://github.com/ionite34/uclip
• Owner: ionite34
• License: mit
• Created: 2022-06-23T01:06:46.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2023-02-08T04:19:51.000Z (almost 2 years ago)
• Last Synced: 2024-10-11T19:45:36.482Z (2 months ago)
• Topics: backblaze-b2, s3-bucket, screenshot, uploader
• Language: Python
• Homepage:
• Size: 270 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## 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