Repository files navigation

Watches clipboard and automatically saves any new images, text and files.

After run, this program will watch the clipboard.

When a new image/text/file is detected, it saves the contents of clipboard with date and time(year to second) information, such as: clip_20201203_101701.png

• It never deletes a previous image/text/file.
• It is fully automatic, you simply fill the clipboard from any source. shotlast does the rest.
• It is useful to save repetitive screenshots from Youtube, Udemy, online meetings, books etc.

In a session, your set of files will look like this:

pip install git+https://github.com/caglartoklu/shotlast

After installation, pip will create an executable (shotlast) for shotlast.

shotlast then can be used from command line as follows:

shotlastshotlast C:\Downloads\Pictures

Note that, on Windows,C:\Python3x\Scripts directory is NOT automatically added to PATH variables.It is advised to add this directory to PATH variables.

or, launch it with a command like this:

C:\Python37\Scripts\shotlast.exe

Currently, Linux is not supported, working on it.SeeIssue 3 "Linux Feedback"

Tkinter is not installed on some Linux derivatives by default.For Debian Linux derivatives, it is installed by:

sudo apt-get install python3-tk

shotlast usesxclipto save images from clipboard on Linux.On Debian derivatives, xclip can be installed as follows:

sudo apt-get install xclip

C:\projects> shotlast --helpusage: shotlast [-h] [--period [PERIOD]] [target_dir]positional arguments:  target_dir         Target directory to store the saved clipboard files.optional arguments:  -h, --help         show this help message and exit  --period [PERIOD]  Sleep duration (in seconds) between two clipboard checks.

Examples:

# make the user select the target directory to save clipboard images:# period will be 2 (the default value)shotlast# make the user select the target directory to save clipboard images:# period will be 3, the provided value.shotlast --period 3# use the values as provided:shotlast --period 3 c:\Pictures\

Runtime Requirements

• Required Python packages are defined insetup.py file.
• Officially, minimum tested Python version supported is 3.7
• Untested: should work with Python 3.5 and above, but not lower, since it uses argparse and pathlib.

Windows 10

Tested and developed with Python 3.7.4 on Windows 10.

Linux

Currently, Linux is not supported, working on it.SeeIssue 3 "Linux Feedback"

macOS

Currently, macOS is not supported, working on it.

makepile.py is the make file of this project.It has no dependencies and it is written in pure Python.

It provides the following commands that can be run from command line:

Shows the main menu of makepile.py and possible targets.

python makepile.pyPossible targets:['clean', 'ctags', 'install', 'linecount', 'pyinstaller', 'readme', 'run', 'uninstall']

shotlast is configured to work withPipenv.It needs to be installed like this:

pip install --user pipenv# orpip install pipenv

Then, after clonning the project, the environment can be created with the following commands:

pipenv shell# install default packagespipenv install# install both default and dev packagespipenv install --dev

Arequirements.txt file is also provided forvirtualenvwrapper.It can be regenerated with the following command:

pipenv requirements --dev > requirements.txt

makepile.py can also use the following tools:

• cloc to count the lines in the project.
• ctags to generate tags.

MIT Licensed.See theLICENSE.txt file.