Skip to content

hakerdefo/pmss

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pmss

pmss (Poor Man's Screenshooter) is a simple bash front-end to screen capture utility Scrot. pmss lets you easily capture screenshots without having to remember various options and flags of Scrot. pmss also utilizes power of xdotool to make the task of taking screenshots in variety of ways not only possible but enjoyable. After taking that perfect screenshot pmss can optionally upload the screenshot to imgur, either anonymously or to an imgur account, and give you image sharing links for GitHub, Reddit, Forums, Message boards, Websites, Blogs. Of course pmss will also give you direct image link and a link to delete the uploaded image. What's more, pmss will also keep a log of all the anonymously uploaded images so you can reuse the image links whenever you need them or remove the uploaded image using the delete link if need be. pmss also lets you empty the whole screenshots directory with a single key press.

Features :

  • Take the screenshot of the entire screen
  • Clean mode
  • Dirty mode
  • Take the screenshot of window in focus
  • Window open below the pmss window
  • Window under the mouse cursor
  • Window selected by the user
  • Take the screenshot of area selected by mouse
  • Upload the screenshot to imgur
  • Anonymous upload
  • Account upload
  • Image sharing links in multiple formats
  • Image upload log
  • Empty screenshots directory with a key press

Dependencies :

Required :

  • Scrot - Scrot is a minimalistic command line screen capturing application. Scrot is available in repositories of almost every linux distribution out there. Use your distribution's package manager to install Scrot.
  • xdotool - xdotool lets you simulate keyboard input and mouse activity. xdotool is available in repositories of almost every linux distribution. You can easily install it from your package manager. For pmss-legacy xdotool is not required.

Optional :

  • curl - curl is a tool to transfer data from or to a server, using one of the supported protocols (DICT, FILE, FTP, FTPS, GOPHER, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET and TFTP). curl is available in repositories of almost every linux distribution. You can easily install it from your package manager.
  • Less - Less is a free, open-source file pager. It can be found on most versions of Linux, Unix and Mac OS, as well as on many other operating systems. Less is available in repositories of almost every linux distribution. You can easily install it from your package manager.

Installation :

Download pmss-master zip, extract its contents into a directory, open that directory in your favorite terminal emulator and copy pmss to /usr/local/bin/ directory,

sudo cp pmss /usr/local/bin/

Next make it executable,

sudo chmod 755 /usr/local/bin/pmss

Usage :

Open terminal, run pmss, say CHEESE!!!

What is a screenshot utility without a screenshot?!?

alt text

My WM hates xdotool or how I loved the original pmss :

No problemo! In the pmss-master zip, You'll find a file named pmss-legacy and all you'll have to do is,

sudo cp pmss-legacy /usr/local/bin/
sudo chmod 755 /usr/local/bin/pmss-legacy

Please say CHEESE now!!!

Support :

If you like pmss, please consider supporting it, even the smallest contribution goes a long way. It is quick & easy via PayPal, Buy Me a Coffee or Liberapay:

Support via PayPal
"Buy Me A Coffee"
Support via Liberapay

License :

Public Domain Mark
This work (pmss, by hakerdefo), identified by hakerdefo, is free of known copyright restrictions.

Credits :

imgur upload function of pmss is based on the work of Bart Nagel & Tino Sino.

OAuth 2.0 setup function of pmss is based on the work of Rany Albeg Wein.

About

pmss (Poor Man's Screenshooter) is a simple screen capture script.

Topics

Resources

License

Stars

Watchers

Forks

Languages