https://github.com/araxeus/screenshotz

Simple Screenshot Tool with quick crop and custom keybinds
https://github.com/araxeus/screenshotz

capture crop custom-keybind java prtscn screen-capture screenshot-utility screenshots software

Last synced: 4 months ago
JSON representation

Simple Screenshot Tool with quick crop and custom keybinds

• Host: GitHub
• URL: https://github.com/araxeus/screenshotz
• Owner: Araxeus
• License: mit
• Created: 2021-02-05T18:19:55.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2023-02-23T09:13:38.000Z (almost 2 years ago)
• Last Synced: 2023-03-05T21:46:27.280Z (almost 2 years ago)
• Topics: capture, crop, custom-keybind, java, prtscn, screen-capture, screenshot-utility, screenshots, software
• Language: Java
• Homepage:
• Size: 5.81 MB
• Stars: 6
• Watchers: 2
• Forks: 0
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
#### Screenshotz is a quick and simple to use screenshot grabber+manager with integrated crop feature 

####  [more features down below]

### Download: - [`[exe]`](https://github.com/Araxeus/ScreenshotZ/releases/download/v1.3/ScreenshotZ-v1.3.exe) / [`[jar]`](https://github.com/Araxeus/ScreenshotZ/releases/download/v1.3/ScreenshotZ-v1.3.jar) from [`[ScreenshotZ-v1.3 Release Page]`](https://github.com/Araxeus/ScreenshotZ/releases/tag/v1.3) 

or from [`[MediaFire Folder]`](https://app.mediafire.com/jl4bs2jieb8c2)

> -> or clone git and compile using maven

#### :x: To launch from _.exe_ you _MUST_ run it as administrator or you will get the following error message: :x:

![alt text](https://github.com/Araxeus/ScreenshotZ/blob/master/resources/NoAdminRights.png?raw=true)

#### :white_check_mark: To do so [on Windows10]: go to the file settings - Compatibility tab - Run this program as administrator :white_check_mark:

![alt text](https://github.com/Araxeus/ScreenshotZ/blob/master/resources/RunAsAdmin.png?raw=true)

#### :full_moon: Running _.jar_ as Administrator perform better but _isn't mandatory_

##### To do it you need to open CMD as administrator and go to the location of the jar and run it with java -jar

###### CMD input example:

        G: ---> dir HDD/Downloads/Opera ---> java -jar ScreenshotZ-v1.3.jar

---

# :sparkles: ScreenshotZ App Features: :sparkles:

:small_orange_diamond:   App launch directly to system tray

:small_orange_diamond:   Option to change default screenshot directory

:small_orange_diamond:  Option to add a Custom Keybind (Save a combination of 1-3 keys) [Does not replace PrtScn button]

:small_orange_diamond:   When PrintScreen is pressed - it will always save to screenshot directory

:small_orange_diamond:   v1.1 added Option to launch Crop UI on Custom Keybind and/or PrtScn

> Cropped picture will be automatically be in your clipboard for easy sharing

:small_orange_diamond:   v1.2 added more Crop Options (Save Original , Exit UI onCrop)

:small_orange_diamond:   App save settings to MyUser/.ScreenshotZ/config.XML

:small_orange_diamond:   Default screenshot directory is MyUser/.ScreenshotZ/Screenshots (Default 2nd keybind is null)

:small_orange_diamond:   To show some debugging: run openWithDebug.bat from same directory as jar OR start program from CMD

:small_orange_diamond:   To add/delete Startup rule run the corresponding bat as Administrator from the same directory as ScreenshotZ-v1.3.exe

:small_orange_diamond:  ProTip: you can press right click to cancel crop (Unnecessary if Exit UI onCrop option is disabled)

#### You can use some Command Line Arguments to take screenshots/+crop them without running the whole program:

-   %arg [-capture] to directly capture screenshot to saved/default directory

-   add %arg [-crop] on top of it to also launch crop UI

    for example in cmd:

           java -jar ScreenshotZ-v1.3.jar -capture -crop

    (App will just take screenshot without launching main thread)

    following this procedure you can bind the core functionality of the program to pretty much anything

    for example: add to explorer.exe context menu the option to instantly crop [TODO will upload reg files for that]

---

## Java classes at src/main/java/core

-   `[TrayApp]` is the main driver class

-   `[SimpleProperties]` is a class that use enums for easy access to settings

-   `[Utils]` are methods that were part of the main class but got refactored out for readability

-   `[GetKeybind]` is the GUI that gets the custom keybind option

-   `[CropImage]` is the crop GUI that is created using [ImagePanel] and uses [TransferableImage] to send to clipboard

---

## Startup Rule Instructions: (Adds startup rule to windows task scheduler) 

-   Grab [`[addStartupRule.bat]`](https://github.com/Araxeus/ScreenshotZ/blob/master/resources/addStartupRule.bat) And

    [`[deleteStartupRule.bat]`](https://github.com/Araxeus/ScreenshotZ/blob/master/resources/deleteStartupRule.bat)

    from the links attached or Tools.zip from the release page

-   Put the bat in same dir as ScreenshotZ-v1.3.exe (rule is for this exact name - can be changed in .bat)

-   Then run the addStartupRule.bat as admin

-   to uninstall run deleteStartupRule.bat as admin and press Y

-   (the exe needs to have admin right enabled in the option as shown above)

---

## SCHTASKS Batch Syntax:

-   HEAD:

'/DELETE - {/TN ...}'

'/CREATE - {/TN /TR /SC ...}'

'/CHANGE {/TN /DISABLE /ENABLE ...}'

-   ARG:

'/SC {MINUTE, HOURLY, DAILY, WEEKLY, MONTHLY, ONCE, ONSTART, ONLOGON, ONIDLE, ONEVENT}' #[task schedule]

'/ST {HH:mm}' #[specify time to run task in 24hour format]

'/D {MON, TUE, WED, THU, FRI, SAT, SUN}' [OR if SC=monthly can use 1-31 representing date OR * representing all days] #[day to execute]

'/TN {FOLDER\TASKNAME}' #[specifies task name and folder (no folder if no \)]

'/TR {PATH}' #[specifies full path to app/script to run on schedule]

'/DELAY {mmmm:ss}' #[specify delay before starting, available only for ONSTART, ONLOGON, and ONEVENT]