Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rjanja/desktop-capture

Screenshot and screencasting tools for Cinnamon.
https://github.com/rjanja/desktop-capture

Last synced: 15 days ago
JSON representation

Screenshot and screencasting tools for Cinnamon.

Awesome Lists containing this project

README 

        
Desktop Capture 

===============

A comprehensive screenshot and screencasting applet for Cinnamon.



![Applet configured for Cinnamon Screenshot and Recorder](https://raw.github.com/rjanja/desktop-capture/master/img/cinnamon-screenshot.png "Applet configured for Cinnamon Screenshot and FFmpeg Recorder")



### Intro 

This project started because I wanted a simple way to choose and switch between capture software packages. There are many options out there and I wanted something to tie them into Cinnamon.



My favorite capture software has always been Shutter, but when I found it wouldn't behave with Cinnamon I decided to write an Cinnamon-specific screenshot utility and integrate it into Desktop Capture. So while Cinnamon Screenshot comes with this applet, you are free to use any capture software you like. Shutter will continue to be supported because it is still a great tool despite being abandonware.



### Features 

* Built-in capture tool: Full screen, Window, Area, Cinnamon UI, Screen, Monitor (and multi-monitor)

* Built-in uploading to Imgur.com

* Copy path/URL/image data to clipboard

* Compatible with screenshot utilities including GNOME-Screenshot, Shutter, xwd, Imagemagick, and Kazam

* Compatible with recorders including RecordMyDesktop, Byzanz, and FFmpeg

* Extensive options and further customisations are possible via JSON support file. 

* Options for changing most configuration settings; further customisations are possible via JSON support file.



![Notification](https://raw.github.com/rjanja/desktop-capture/master/img/notification.png "Notifications")



### Non-english translations

Thanks to the contributions by users there are multiple translations available:



* Chinese, courtesy of [giwhub](https://github.com/giwhub)

* Czech, courtesy of [radek71](https://github.com/radek71)

* German, courtesy of [NikoKrause](https://github.com/NikoKrause)

* Swedish, courtesy of [eson57](https://github.com/eson57)



Thank you so much, guys!



### Requirements



This applet is multi-version, meaning different versions of Cinnamon will have different experiences and functionality.



Beginning with Cinnamon **2.6** anonymous imgur uploads are supported (once more).



Beginning with Cinnamon **3.2** authenticated imgur uploads are supported, and there is an included wizard to help you connect to your account.



![Imgur](https://raw.github.com/rjanja/desktop-capture/master/img/imgur-album.png "Choosing the album to upload into, once connected to your imgur account")



### Installation 



Make sure you have Cinnamon 2.6 or newer



* Clone source or Download ZIP

* Move `capture@rjanja` folder into `~/.local/share/cinnamon/applets/`

* Restart Cinnamon (`Alt+F2`, `r`)

* Add Desktop Capture applet to your panel



### Selection modes - advanced usage 

* ##### Area

    * Use directional keys (up, left, down, right) to move selection

    * Hold shift while using directional keys to resize selection

    * Press ENTER to complete capture



* ##### Cinnamon UI

    * Move your mouse cursor over an actor

    * Use mousewheel scroll up/down to traverse hierarchy through reactive actors

    * Hold shift while clicking to activate an actor

    * Click (without holding shift) to complete capture



### Adding program support 

A number of program-specific options can be set for your preferred capture program by manually editing the `support.json` file. New programs can be added by creating a new block, just remember not to use trailing commas on the last elements and do not try to add comments as they seem to break the parser.



![Extending](https://raw.github.com/rjanja/desktop-capture/master/img/custom-entries.png "Extending program support")



For camera/screenshot programs, a standard set of "supported" features can be enabled. If they are missing, or set to false, they will be considered to be disabled/not present. Custom options can be supplied which will appear after the standard supported options, with the key being the text that shall be shown and the value being the full command to run, including the executable name.



For recorder/screencast programs, there is no similar list of "supported" features; only "custom" entries are used here.



### Thanks

* The Linux Mint development team and contributors for all of their efforts!

* infektedpc, who developed the very first screenshot applet for Cinnamon!

* Ben Scholzen, author of Shell's Area Screenshot extension, from which area selection and timer have been integrated and improved upon

* The author(s) of Shell's capture backend, from which Cinnamon has benefited