-
Notifications
You must be signed in to change notification settings - Fork 23
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
release version 1.0.0 and update readme/man
- Loading branch information
Showing
4 changed files
with
127 additions
and
72 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,65 +1,90 @@ | ||
| .TH ESCROTUM 1 "January 2018" | ||
| .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.12. | ||
| .TH ESCROTUM "1" "January 2020" "escrotum 0.2.1" "User Commands" | ||
| .SH NAME | ||
| escrotum \- screenshot capture program inspired by scrot | ||
| .SH SYNOPSIS | ||
| .B escrotum | ||
| [\fI\,OPTION\/\fR]... [\fI\,FILENAME\/\fR] | ||
| escrotum \- Minimalist screenshot capture and screen recording program inspired by scrot. | ||
| .SH DESCRIPTION | ||
| Minimalist screenshot capture program inspired by scrot. | ||
| .PP | ||
| .I FILENAME | ||
| optional positional argument defines image filename, default is %Y-%m-%d-%H%M%S_$wx$h_escrotum.png | ||
| usage: escrotum [\-h] [\-v] [\-s] [\-x XID] [\-d DELAY] | ||
| .IP | ||
| [\-\-selection\-delay SELECTION_DELAY] [\-c] [\-C] [\-e COMMAND] | ||
| [\-r] | ||
| [FILENAME] | ||
| .PP | ||
| \fB\-\-exec\fR option (see below) and \fIFILENAME\fR parameters can take format specifiers that are expanded by escrotum when encountered. | ||
|
|
||
| There are two types of format specifier. Characters preceded by a '%' are interpreted by \fBstrftime\fR(2). These options may be used to refer to the current date and time. The second kind are internal to escrotum and are prefixed by '$'. The following specifiers are recognised: | ||
| .br | ||
| $f - image path/filename (ignored when used in the \fIFILENAME\fR) | ||
| .br | ||
| $h - image height | ||
| .br | ||
| $w - image width | ||
| .SH OPTIONS | ||
| Minimalist screenshot capture and screen recording program inspired by scrot. | ||
| .SS "positional arguments:" | ||
| .TP | ||
| \fB\-C\fR, \fB\-\-clipboard\fR | ||
| store the image on the clipboard | ||
| FILENAME | ||
| image filename, default is | ||
| %Y\-%m\-%d\-%H%M%S_$wx$h_escrotum.png | ||
| .SS "optional arguments:" | ||
| .TP | ||
| \fB\-c\fR, \fB\-\-countdown\fR | ||
| show a countdown before taking the shot (requires delay) | ||
| \fB\-h\fR, \fB\-\-help\fR | ||
| show this help message and exit | ||
| .TP | ||
| \fB\-d\fR, \fB\-\-delay\fR=\fI\,SECONDS\/\fR | ||
| wait specified number of seconds before taking a shot | ||
| \fB\-v\fR, \fB\-\-version\fR | ||
| output version information and exit | ||
| .TP | ||
| \fB\-e\fR, \fB\-\-exec\fR=\fI\,COMMAND\/\fR | ||
| run specified command after the image is taken | ||
| \fB\-s\fR, \fB\-\-select\fR | ||
| interactively choose a window or rectangle with the | ||
| mouse, cancels with Esc or Right Click | ||
| .TP | ||
| \fB\-h\fR, \fB\-\-help\fR | ||
| show help message and exit | ||
| \fB\-x\fR XID, \fB\-\-xid\fR XID | ||
| take a screenshot of the xid window | ||
| .TP | ||
| \fB\-s\fR, \fB\-\-select\fR | ||
| interactively choose a window or rectangle with the mouse, cancels with Esc or Right Click | ||
| \fB\-d\fR DELAY, \fB\-\-delay\fR DELAY | ||
| wait DELAY seconds before taking a shot | ||
| .TP | ||
| \fB\-\-selection\-delay\fR=\fI\,MILLISECONDS\/\fR | ||
| wait specified number of milliseconds before taking a shot after selection | ||
| \fB\-\-selection\-delay\fR SELECTION_DELAY | ||
| delay in milliseconds between selection/screenshot | ||
| .TP | ||
| \fB\-v\fR, \fB\-\-version\fR | ||
| output version information and exit | ||
| \fB\-c\fR, \fB\-\-countdown\fR | ||
| show a countdown before taking the shot (requires | ||
| delay) | ||
| .TP | ||
| \fB\-x\fR, \fB\-\-xid\fR=\fI\,XID\/\fR | ||
| take a screenshot of the xid window | ||
| .SH EXIT STATUS | ||
| \fB\-C\fR, \fB\-\-clipboard\fR | ||
| store the image on the clipboard | ||
| .TP | ||
| \fB\-e\fR COMMAND, \fB\-\-exec\fR COMMAND | ||
| run the command after the image is taken | ||
| .TP | ||
| \fB\-r\fR, \fB\-\-record\fR | ||
| screen recording. Alt+Ctrl+s to stop the recording | ||
| .IP | ||
| SPECIAL STRINGS | ||
| Both the \fB\-\-exec\fR and filename parameters can take format specifiers | ||
| that are expanded by escrotum when encountered. | ||
| .IP | ||
| There are two types of format specifier. Characters preceded by a '%' | ||
| are interpreted by strftime(2). See man strftime for examples. | ||
| These options may be used to refer to the current date and time. | ||
| .IP | ||
| The second kind are internal to escrotum and are prefixed by '$' | ||
| The following specifiers are recognised: | ||
| .IP | ||
| $f image path/filename (ignored when used in the filename) | ||
| $w image width | ||
| $h image height | ||
| .IP | ||
| Example: | ||
| .IP | ||
| escrotum '%Y\-%m\-%d\-%H%M%S_$wx$h_escrotum.png' | ||
| Creates a file called something like 2013\-06\-17\-082335_263x738_escrotum.png | ||
| .IP | ||
| EXIT STATUS CODES | ||
| 1 can't get the window by xid | ||
| .br | ||
| 2 invalid pixbuf | ||
| .br | ||
| 3 can't save the image | ||
| .br | ||
| 4 user canceled selection | ||
| .br | ||
| 5 can't grab the mouse | ||
| .SH AUTHOR | ||
| Roger Duran <[email protected]> | ||
| .SH COPYRIGHT | ||
| Copyright © Roger Duran. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>. | ||
| .br | ||
| This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. | ||
| 6 error with ffmpeg | ||
| .SH "SEE ALSO" | ||
| The full documentation for | ||
| .B escrotum | ||
| is maintained as a Texinfo manual. If the | ||
| .B info | ||
| and | ||
| .B escrotum | ||
| programs are properly installed at your site, the command | ||
| .IP | ||
| .B info escrotum | ||
| .PP | ||
| should give you access to the complete manual. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -2,15 +2,19 @@ | |
|
|
||
| setup( | ||
| name="escrotum", | ||
| version="0.2.1", | ||
| version="1.0.0", | ||
| author='Roger Duran', | ||
| author_email='[email protected]', | ||
| url='https://github.com/Roger/escrotum', | ||
| download_url='https://github.com/Roger/escrotum/archive/0.2.1.tar.gz', | ||
| keywords=['screenshot', 'scrot', 'cli'], | ||
| download_url='https://github.com/Roger/escrotum/archive/1.0.0.tar.gz', | ||
| keywords=['screenshot', 'screen-recording', 'scrot', 'cli'], | ||
| packages=["escrotum"], | ||
| include_package_data=True, | ||
| zip_safe=False, | ||
| install_requires=[ | ||
| 'python-gobject', | ||
| 'xcffib', | ||
| ], | ||
| entry_points={ | ||
| 'console_scripts': [ | ||
| 'escrotum = escrotum.main:run', | ||
|
|
||