Skip to content

JustFocus is a minimalist and elegant desktop application designed to help you maintain focus during your work sessions

License

Notifications You must be signed in to change notification settings

goto-eof/justfocus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

MacOS installation

Download and install the .pkg file. 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.

sudo snap install justfocus

Linux Installation (dpkg)

It is possible to install Just Focus by downloading the .deb package and by installing it:

sudo dpkg -i just-focus_*.*.*_amd64.deb

In order to remove the application:

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

screenshot

License

This project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.


Useful stuff

Flickering

In order to avoid flickering on Ubuntu:

-Dsun.java2d.opengl=true -Dsun.java2d.xrender=true

Build and execute the snap

sudo snap remove justfocus ; snapcraft clean; snapcraft; sudo snap install justfocus_*.*.*_amd64.snap --dangerous; justfocus

Publish snap

snapcraft upload --release=stable justfocus_*.*.*_amd64.snap

Build .deb package (Linux)

jpackage \
--type deb \
--name "Just Focus" \
--vendor "Andrei Dodu" \
--app-version "3.1.0" \
--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)

jpackage ^
--type exe ^
--name "Just Focus" ^
--vendor "Andrei Dodu" ^
--app-version "3.1.0" ^
--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)

#!/bin/bash

jpackage \
--type pkg \
--name "Just Focus" \
--vendor "Andrei Dodu" \
--app-version "3.1.0" \
--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.

About

JustFocus is a minimalist and elegant desktop application designed to help you maintain focus during your work sessions

Resources

License

Stars

Watchers

Forks

Packages

No packages published