zekesonxx / puush4linux

Linux client for the popular screenshot host puush.me

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

puush4linux

puush4linux is a Linux client for the popular screenshot host puush. puush4linux aims to reach feature parity with the official Windows puush client. It currently supports authentication, taking screenshots and file uploading.

Installation

Arch Linux users may install the puush4linux package from the AUR, packaged by /u/some_random_guy_5345.

  1. Install dependencies: bash, scrot, curl, and xclip; optionally: libnotify, optipng, xdotool, maim and slop. If maim and slop are installed, maim is preferred over scrot when taking screenshots.
  2. Download the puush file and copy it to /usr/bin.
  3. Run puush -l in your terminal and enter your user name and password to log in.
  4. Set up shortcuts in your window manager/desktop environment to your liking. Example (XFCE): xfce4 shortcut example

Usage

puush <options> [filename]

You do not need to specify the file name if you are going to use the script to take a screenshot.

Options

-q - Don't show any notifications on the desktop. (Notifications are automatically disabled if libnotify isn't found on the system.)

-c - Copy the URL of the uploaded file to X clipboard. If this is not specified, the URL will be sent to stdout.

-h - Display help.

-a - Take a screenshot of an area and then upload it.

-f - Take a screenshot of the entire screen and upload it.

-w - Take a screenshot of the active window and upload it. If using maim, xdotool is required.

-l - (Re-)log in to puush with your username and password.

-b - Don't optimize images with optipng; only applies when using -afw (Automatically disabled if optipng isn't found on the system)

-s - Use scrot even if maim and slop are installed.

Optional environment variables

PUUSH_SCREENSHOT_DIR - Directory in which to save screenshots. If defined, screenshots are not deleted after uploading. If not defined, "/tmp" is used.

PUUSH_DATE_FORMAT - Date format for file name. See man date for information. Default is "%d-%m-%Y-%H%M%S".

Examples

puush -c -a - Take a screenshot of an area, upload it and put the link into the clipboard. (Equivalent to Ctrl+Shift+4 on Windows systems.)

puush -q myfile.png - Upload an image and print the uploaded file URL to stdout without displaying desktop notifications.

env PUUSH_SCREENSHOT_DIR="$HOME/Pictures" PUUSH_DATE_FORMAT="%y-%m-%d_%H%M%S" puush -f - Take a screenshot of the entire screen, store it in the '~/Pictures' folder and use date format yy-mm-dd_HHMMSS for the filename.

Author & License

Original version created by Darwin with ♥, licensed under the WTFPL v2

This version is a fork of the original, and has been relicensed under the Apache License v2, see LICENSE.

WTFPL is not a legally or morally responsible license, which is why this fork won't be using it.

About

Linux client for the popular screenshot host puush.me

License:Apache License 2.0


Languages

Language:Shell 100.0%