https://github.com/wkentaro/screenshot-manager

Organize screenshot/screencast in a uniform manner.
https://github.com/wkentaro/screenshot-manager

screencast screenshot

Last synced: 2 days ago
JSON representation

Organize screenshot/screencast in a uniform manner.

• Host: GitHub
• URL: https://github.com/wkentaro/screenshot-manager
• Owner: wkentaro
• License: mit
• Created: 2018-10-24T19:22:09.000Z (almost 6 years ago)
• Default Branch: main
• Last Pushed: 2022-02-23T21:58:47.000Z (over 2 years ago)
• Last Synced: 2024-09-10T19:26:09.265Z (23 days ago)
• Topics: screencast, screenshot
• Language: Python
• Homepage:
• Size: 1.09 MB
• Stars: 7
• Watchers: 4
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
screenshot-manager


Organize screenshot/screencast in a uniform manner.




  

  

  





  



## Why?

I usually take screenshot/screencast just for logging in daily basis. It is quite useful if we put them in a single folder or cloud service (e.g., Google Drive)

to synchronize them among multiple devices and platforms. However, sometimes this is difficult because of the default saving location

of screenshot (e.g., `~/Desktop` on macOS) and difference of the name

(e.g., `Screenshot from %Y-%m-%d %H-%M-%S.png` on Ubuntu and `Screen Shot %Y-%m-%d at %H.%M.%S.png`, `Kapture %Y-%m-%d at %H.%M.%S.mp4` on macOS).

This software serves some solutions for this with a simple Python script and Cron job.

## How to use it?

First, you need to install the python script:

```

pip install screenshot-manager

```

Next, you run `crontab -e` to add the periodical job:

```

*/5 * * * * /usr/local/bin/screenshot-manager --to-location ~/GoogleDrive/Screenshots

```

That's it!

If you want to change some of the default behavior,

please refer to [Advanced usage](#advanced-usage).

## Advanced usage

```

# To check the behavior.

screenshot-manager --verbose

# You can configure the source location and others.

# See screenshot-manager --help for more detail.

screenshot-manager --from-location ~/Documents ~/Desktop

screenshot-manager --from-format 'Video from %Y-%m-%d %H-%M-%S'

screenshot-manager --to-format '%Y-%m-%d-%H-%M-%S'

```

## Supported formats

If it is not supported, the screenshot will be just copied without renaming.  

Please check output of `screenshot-manager --verbose` or `screenshot_manager/cli.py` to see the supported formats.