Skip to content

A Python implementation of the file-upload/screenshot tool Puush for use on Linux

License

Notifications You must be signed in to change notification settings

KoffeinFlummi/puush-linux

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

puush for Linux

License

A Python 3 implementation of Puush for Linux.

Setup

$ python3 setup.py install
  • In order to take screenshots, you need scrot installed and in your PATH.
  • In order to use the clipboard option, you need xclip (WARNING: sourceforge link) installed and in your PATH.
  • If you want to play the beep when the upload is finished, the play command has to be available. It is most likely found in the sox package of your respective package manager.

API Key

In order to use Puush, you have to have an API key. To retrieve your API key, log into your Puush account and get your API key; to be found under Account > Settings.

You can either pass the key to Puush in the environment variable PUUSH_API_KEY or by dumping it into the file ~/.config/puush/key.

Usage

puush for linux

Usage:
    puush [-cmd] upload <file>...
    puush [-cmd] (window | desktop | area)
    puush -h | --help

Commands:
    upload          Upload the specified file(s)
    window          Take a screenshot of the current window and upload it
    desktop         Take a screenshot of the entire desktop and upload it
    area            Take a screenshot of a certain area and upload it

Options:
    -c --clipboard  Copy the URL to clipboard additionally to STDOUT
    -m --mute       Mute. Don't play beep.
    -d --debug      Show debug messages.
    -h --help       Show this help

Keybindings

If you want to use the same keybindings that you are used to on Windows, you will have to set those in your WM/DE settings. If you use a full DE like KDE, XFCE, Gnome/Cinnamon or Unity, you will find a keybindings option in your system settings.

Below is a sample configuration for the i3 window manager:

# Puush keybindings
bindsym Ctrl+Shift+2    exec --no-startup-id puush -c window
bindsym Ctrl+Shift+3    exec --no-startup-id puush -c desktop
bindsym Ctrl+Shift+4    exec --no-startup-id puush -c area

Disclaimers

This is not an official Puush implementation and I'm not affiliated with the creator(s) of Puush.

The method for the upload has been taken from here.

About

A Python implementation of the file-upload/screenshot tool Puush for use on Linux

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages