https://github.com/raydac/japagoge

Simple animated PNG and GIF screen recorder
https://github.com/raydac/japagoge

apng gif gif-recorder java peek screen-capture screencast screencast-recording

Last synced: 2 months ago
JSON representation

Simple animated PNG and GIF screen recorder

• Host: GitHub
• URL: https://github.com/raydac/japagoge
• Owner: raydac
• License: apache-2.0
• Created: 2021-08-29T23:07:10.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2025-01-31T09:31:36.000Z (8 months ago)
• Last Synced: 2025-04-13T22:39:25.562Z (6 months ago)
• Topics: apng, gif, gif-recorder, java, peek, screen-capture, screencast, screencast-recording
• Language: Java
• Homepage:
• Size: 3.41 MB
• Stars: 17
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: changelog.txt
  • License: LICENSE

Awesome Lists containing this project

README

          
![Banner image](assets/banner.png)

# Japagoge (PNG and GIF screen recorder)

[![License Apache 2.0](https://img.shields.io/badge/license-Apache%20License%202.0-green.svg)](http://www.apache.org/licenses/LICENSE-2.0)

[![Java 9+](https://img.shields.io/badge/java-9%2b-green.svg)](https://bell-sw.com/pages/downloads/#/java-11-lts)

[![PayPal donation](https://img.shields.io/badge/donation-PayPal-cyan.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=AHWJHJFBAWGL2)

[![YooMoney donation](https://img.shields.io/badge/donation-Yoo.money-blue.svg)](https://yoomoney.ru/to/41001158080699)

> **Warning**   

> In Linux. If you get black screen as grabbing result, then it is

> bug [JDK-8269245](https://bugs.openjdk.org/browse/JDK-8269245). You can switch your session to X11 (under Ubuntu it is

> possible through login screen) to get it properly working.

> **Warning**   

> In MacOS. If you can't manipulate content under grabbing window by mouse, then it is

> bug [JDK-8013450](https://bugs.openjdk.java.net/browse/JDK-8013450).

## Changelog

- 2.1.7 (SNAPSHOT)

  - updated embedded JDK to 23+38

- 2.1.6 (01-nov-2023)

  - updated embedded JDK to 21.0.1+12

- 2.1.5 (20-sep-2022)

  - native windows launcher moved from i386 to amd64 to prevent antivirus false positive detection

  - updated embedded JDK to 17.0.4.1+1

  - updated dependencies

[Full changelog](changelog.txt)

## Pre-word

While working on [an article](https://habr.com/ru/post/576012/) for a well-known web resource, I needed to create

animated GIFs, and I had planned to use

the popular [Peek](https://github.com/phw/peek) utility for this purpose. However, to my surprise, I discovered that

this utility does not support

multi-display environments. I had to quickly devise a Java-based solution that could capture animations and save them

to a file. Initially, I opted to record animations as animated PNG files since it was simpler, but later,

I also implemented the conversion to GIF.

## Pre-built

| OS                                           | Download link                                                                                                                                     | 

|----------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|

| ![Windows](assets/icons/win64x64.png)        | __[Archive for Windows x64 (JRE included)](https://github.com/raydac/japagoge/releases/download/2.1.6/japagoge-app-2.1.6-windows-jdk-amd64.zip)__ |

| ![OSX](assets/icons/macos64x64.png)          | __[Archive for OSX x64 (JRE included)](https://github.com/raydac/japagoge/releases/download/2.1.6/japagoge-app-2.1.6-macos-jdk-amd64.zip)__       |

| ![OSX Arm64](assets/icons/macosarm64x64.png) | __[Archive for OSX Arm64 (JRE included)](https://github.com/raydac/japagoge/releases/download/2.1.6/japagoge-app-2.1.6-macos-jdk-aarch64.zip)__   |

| ![Linux](assets/icons/linux64x64.png)        | __[Archive for Linux x64 (JRE included)](https://github.com/raydac/japagoge/releases/download/2.1.6/japagoge-app-2.1.6-linux-jdk-amd64.tar.gz)__  |

| ![Linux](assets/icons/appimage64x64.png)     | __[Archive for Linux x64 (AppImage)](https://github.com/raydac/japagoge/releases/download/2.1.6/japagoge-app-2.1.6-x86_64.AppImage)__             |

| ![Java](assets/icons/java64x64.png)          | __[Cross-platform JAR file](https://github.com/raydac/japagoge/releases/download/2.1.5/japagoge-app-2.1.6.jar)__                                  | 

## How to use the utility?

You can download its distributive for your OS from [the releases page](https://github.com/raydac/japagoge/releases). It

requires Java 11+ for work but some archives provide bundled JRE. Keep in mind that it is very tricky to grab mouse

pointer appearance under Java so grabbed pointer look may differ from your system one.

### Positioning

Just after start, the window in positioning mode and shown in green color. Supported only mouse, and you can drag the

window and resize it to cover required capture area. During positioning mode, you can see three buttons in top of the

application window. The leftmost button is the main one and if click on it, recording will start. The middle button is

to edit application settings and the rightmost button to close application.   

![Positioning state](assets/screens/state_positioning.png)

### Recording

__Recording activated by single click by mouse on the leftmost button in the window title area__. In the recording mode

all auxiliary buttons will be removed and the window changes its color. Only stop record button will be blinking one in

the leftmost corner.       

![Positioning state](assets/screens/state_recording.png)   

__To stop recording, you should make mouse double-click on the blinking button in the title area.__ After recording

stop, you will see the save file dialog to save the record file, if you press cancel button then the record will be

rejected and just deleted. If you choose GIF file type then conversion will be started, it can take some time and

depends on power of your computer. You can select different options for saved GIF files in settings, but you have to do

it before record.

### Settings

You can tune misc record options. For instance disable show of mouse pointer or limit number of loops in the result

record show. To do it you should click the setting button and the Settings dialog will be opened.   

![Positioning state](assets/screens/state_preferences.png)

- __Temp folder__ allows define the folder where intermediate files will be saved, if empty then default temp folder in

  use.

- __Capture delay (ms)__ delay between shots of the recorded area in milliseconds.

- __Frame delay (ms)__ delay between frame show in result animation in milliseconds. If different with `Capture delay`

  then animation will be either faster or slower.

- __Loops__ is number of ami,ation loops to be played during result animation show, zero means infinity animation.

- __Show capturing area metrics__ allows turn on information about capturing area coordinates during positioning.

- __Grab mouse pointer__ allows grab position of mouse pointer and show it in the result animation.

- __Color filter__ allows make some preprocessing of colors and make it gray or amber for instance. Decreasing result

  file size.

- __Palette RGB to GIF__ provides palette to be used during GIF conversion, AUTO means some global auto-palette formed

  on statistic data.

- __Better RGB colors to GIF__ allows increase precision of palette color search during GIF conversion but make process

  much slower.

- __Dithering GIF__ makes dithering in the result GIF to get better quality with provided palette but makes file much

  bigger and process much slower.

- __Force whole frame__ allows turn off optimization of saved frames and save whole frame, sometime can help in

  dithering GIF conversion if area border artifacts presented.

### Known bugs

#### Under MacOS mouse pointer looks differ from system one

I have not found yet way to grab mouse pointer icon under MacOS..