https://github.com/roboloop/qs

qs (Quick Share) is a privacy-focused tool to upload media to Imgur 🏞️
https://github.com/roboloop/qs

bash bash-script imgur media-management media-publisher privacy-protection secure shell

Last synced: 25 days ago
JSON representation

qs (Quick Share) is a privacy-focused tool to upload media to Imgur 🏞️

• Host: GitHub
• URL: https://github.com/roboloop/qs
• Owner: roboloop
• License: mit
• Created: 2025-04-01T13:35:31.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-04-03T10:21:53.000Z (about 1 year ago)
• Last Synced: 2025-04-03T11:26:12.519Z (about 1 year ago)
• Topics: bash, bash-script, imgur, media-management, media-publisher, privacy-protection, secure, shell
• Language: Shell
• Homepage:
• Size: 4.88 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# qs

Quickly share any media to Imgur via a shell script — keeping you as anonymous as possible.

![preview.gif](./preview.gif)

## Features

- Removes metadata before uploading

- Tracks all uploaded media 

- Pastes to a clipboard + OS notifications

## Requirements

- OS Linux/MacOS

- [curl](https://curl.se/)

- _(optional)_ [exiftool](https://exiftool.org/)

## Setup

1. Install in `$HOME/.qs`

   ```shell

   curl -sL https://raw.githubusercontent.com/roboloop/qs/refs/heads/main/install.sh | bash

   ```

2. Make the program globally accessible by adding to the corresponding command to the shell-config

   ```shell

   export PATH="$HOME/.qs:$PATH"`

   ```

## Usage

```shell

Usage:

  qs  [arguments]

The commands are:

  upload      uploads media (filepath, url, or stdin media is accepted)

    --no-copy to skip copying the result link

  delete      deletes all media files

  list        prints all uploaded media

Other environments:

  IMGUR_CLIENT_ID   overrides client_id

Examples:

  qs upload '/user/media/example.jpeg'   # Upload example.jpeg to Imgur

  qs delete                              # Removes all uploaded media

  qs list                                # Prints all uploaded media

```