https://github.com/goto-eof/justfocus
JustFocus is a minimalist and elegant desktop application designed to help you maintain focus during your work sessions
https://github.com/goto-eof/justfocus
Last synced: 4 months ago
JSON representation
JustFocus is a minimalist and elegant desktop application designed to help you maintain focus during your work sessions
- Host: GitHub
- URL: https://github.com/goto-eof/justfocus
- Owner: goto-eof
- License: other
- Created: 2025-06-01T18:28:39.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-10-22T17:23:51.000Z (9 months ago)
- Last Synced: 2025-10-22T19:24:47.429Z (9 months ago)
- Language: Java
- Homepage:
- Size: 599 KB
- Stars: 7
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
- [Introduction](#introduction)
- [Download](#download)
Just Focus
### A Distraction-Free Focus Timer for Linux Desktops
JustFocus is a minimalist and elegant desktop application designed to help you maintain focus during your work sessions.
Built with Java Swing, this unobtrusive timer sits cleanly on your desktop, providing clear visual feedback
without unnecessary distractions.
**Key Features:**
* **auto-enables/disables the `Do Not Disturb`** functionality on Gnome desktops
* **Minimalist Design:** A clean, undecorated circular UI that blends seamlessly with your desktop environment.
* **Visual Progress Indicator:** A smooth, animated arc visually represents the time remaining in your focus session,
offering intuitive feedback at a glance.
* **Focus-Oriented:** Designed for dedicated work, JustFocus provides a fixed-duration timer (e.g., 30 minutes) without
pause functionality, encouraging uninterrupted concentration.
* **Lightweight & Efficient:** Optimized for size and performance, making it a nimble addition to your workflow.
----
Download
### Windows installation
Download and install the
following [executable file](https://github.com/goto-eof/justfocus/releases/download/3.1.3/Just.Focus-3.1.3.exe).
### MacOS installation
Download and install the `.pkg` [file](https://github.com/goto-eof/justfocus/releases/download/3.1.3/Just.Focus-3.1.3.pkg). Remember to allow the installation from unknown sources.
### Linux Installation (Snap)
JustFocus is available as a Snap package for easy installation on most Linux distributions.
```bash
sudo snap install justfocus
```
### Linux Installation (dpkg)
It is possible to install Just Focus by downloading the
`.deb` [package](https://github.com/goto-eof/justfocus/releases/download/3.1.3/just-focus_3.1.3_amd64.deb) and by
installing it:
```bash
sudo dpkg -i just-focus_*.*.*_amd64.deb
```
In order to remove the application:
```bash
sudo apt-get remove just-focus
```
----
### Technologies
- Java (Swing)
### Contributing
Contributions are welcome! If you have suggestions for features, bug reports, or would like to contribute code, please
feel free to open an issue or pull request on the GitHub repository.
### Screenshot
### License
This project is licensed under
the [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-nc-sa/4.0/).
----
# Useful stuff
### Flickering
In order to avoid flickering on Ubuntu:
```bash
-Dsun.java2d.opengl=true -Dsun.java2d.xrender=true
```
### Build and execute the snap
```bash
sudo snap remove justfocus ; snapcraft clean; snapcraft; sudo snap install justfocus_*.*.*_amd64.snap --dangerous; justfocus
```
### Publish snap
```bash
snapcraft upload --release=stable justfocus_*.*.*_amd64.snap
```
### Build `.deb` package (Linux)
```bash
jpackage \
--type deb \
--name "Just Focus" \
--vendor "Andrei Dodu" \
--app-version "3.1.3" \
--input "target" \
--main-jar "just-focus.jar" \
--icon "icon.png" \
--main-class "com.andreidodu.Main" \
--dest "." \
--add-modules java.base,java.desktop \
--linux-shortcut \
--java-options "-Dsun.java2d.opengl=true -Dsun.java2d.xrender=true -Djdk.gtk.version=3" \
--verbose
```
### Build `.exe` file (Windows)
```bat
jpackage ^
--type exe ^
--name "Just Focus" ^
--vendor "Andrei Dodu" ^
--app-version "3.1.3" ^
--input "target" ^
--main-jar "just-focus.jar" ^
--icon "icon.ico" ^
--main-class "com.andreidodu.Main" ^
--dest "." ^
--add-modules java.base,java.desktop ^
--java-options "-Dsun.java2d.opengl=true -Dsun.java2d.xrender=true" ^
--verbose ^
--win-shortcut ^
--win-menu
```
### Build `.pkg` file (MacOS)
```bash
#!/bin/bash
jpackage \
--type pkg \
--name "Just Focus" \
--vendor "Andrei Dodu" \
--app-version "3.1.3" \
--input "target" \
--main-jar "just-focus.jar" \
--icon "icon.png" \
--main-class "com.andreidodu.Main" \
--dest "." \
--add-modules java.base,java.desktop \
--java-options "-Dsun.java2d.opengl=true -Dsun.java2d.xrender=true -Djdk.gtk.version=3" \
--verbose
```
# Moreover...
Tested on Ubuntu 25.04, built on Debian 10 (`.deb` package). Because this project was conceived for Ubuntu, so for GNOME
desktop environment, the application is fully compatible with Ubuntu. In particular the enable/disable "Do Not Disturb"
feature is available only on Ubuntu. The same feature is not available on Windows because there are important
changes between Windows 10 and Windows 11 and frankly, I need more time in order to learn Windows API.