A few useful answers

Frequently asked questions

The essentials about Lofitime's Mac requirements, focus timers, music playback, and session history. For a step-by-step walkthrough, start with the getting started guide.

Compatibility and installation

What is Lofitime?

Lofitime is a small, free Mac app with a menu-bar Pomodoro timer, lo-fi YouTube radio, and a tiny room that fills with furniture and plants as you finish sessions. It’s made for fun.

Which Macs are supported?

Lofitime requires macOS 14 or later. Published releases support both Apple Silicon and Intel Macs and are signed and notarized.

How do I install it?

Use the download link, open the release DMG, and drag Lofitime.app into Applications. Then launch the app from Applications. See the installation guide for details.

Is this a web timer, or is there a Windows or mobile version?

Lofitime is a macOS desktop app. This website documents the Mac app, not a browser timer or an iPhone, Android, Windows, or Linux version.

Timers and menu-bar controls

Can I change the Pomodoro durations?

Yes. Change timer defaults in Settings for your regular routine. For a one-off session, edit a paused countdown: enter 45 for 45 minutes or 25:30 for 25 minutes and 30 seconds. See the Pomodoro guide.

Why isn’t Lofitime in the Dock?

It launches in the menu bar. Choose Open Lofitime, Stats, or Settings in the popup to open the larger window and show the Dock icon. A minimized window keeps its Dock icon. Closing the window returns to menu-bar-only mode.

Does closing the window stop the timer or music?

No. Both keep running. To quit completely, choose Quit Lofitime in the popup’s menu, or use ⌘ Q while Lofitime is active.

Are breaks automatic?

Lofitime offers optional automatic breaks. Open Settings to choose the break behavior and timer defaults that suit your routine.

Music and internet access

Which music stations are available?

The stations are Chill house, Study lo-fi, Sleepy lo-fi, and Synthwave. Chill house is the default. Music plays through embedded Lofi Girl YouTube livestreams; see the music guide.

Can I use the timer without music?

Yes. Music and timers work independently. You can run a silent focus session or listen to a station without starting a timer.

Can I listen offline?

Radio playback requires an internet connection. Lofitime uses live YouTube streams rather than an offline music library or downloaded tracks.

Is Lofitime affiliated with Lofi Girl or YouTube?

No. Lofitime is independent. Music and artwork belong to their respective owners, and the streams are played through YouTube's embedded player.

History and preferences

Where do I see completed sessions?

Choose Stats from the popup or the main window, or use ⌘ 2 while using the app. It shows daily sessions, weekly bars, monthly totals, and all-time focus. Click a day for its sessions.

What happens to the room if I take a week off?

The decorations follow your last seven days of sessions, so the room gradually returns to its basics. Your session history and totals are kept.

Is my session history stored locally?

Yes. Sessions are saved on your Mac. If you turn on GitHub sync, completed session times, durations, and intentions also go to the private repository you connect.

Can I sync between Macs?

Yes. In Settings, create a private sync repository on the first Mac, then connect the other Macs using its repository link. Lofitime uses GitHub CLI authentication and merges completed sessions automatically. Active timers, music, and preferences stay per-Mac. See the sync setup guide.

Which themes are included?

Candlelight, Catppuccin, Moss, Moonlight, Rosewood, and Tokyo Night. Choose one in Settings; the interface, furniture accents, and running Dock icon follow it.

Can Lofitime launch when I log in?

Yes. Launch at login is available in Settings, alongside timer defaults, themes, and startup preferences. The app also supports automatic updates.

Source code and support

Where is the source code?

The GitHub repository contains the SwiftUI app. To build it, install Swift 6 or later and recent Apple Command Line Tools or Xcode, then run make run in the repository. make help lists the build and test commands.

How do I report a problem?

Open a GitHub issue or email [email protected]. Include your macOS version, Lofitime version, steps to reproduce, and what you expected to happen. For music issues, include the station. Avoid sharing private session details unnecessarily.