Documentation
Getting Started
System Requirements
- macOS 13.0 (Ventura) or higher
- Approximately 10MB of available storage space
- Intel or Apple Silicon processor
Installation
- Download the latest version of ImmersiveTime from the download page.
- Unzip the downloaded file.
- Drag the ImmersiveTime application to your Applications folder.
- Launch ImmersiveTime from your Applications folder or using Spotlight.
First Launch
When you first launch ImmersiveTime, you'll see the app icon appear in your menu bar. Click on the icon to access the main menu. From here, you can:
- View the current time in your local time zone
- Add additional time zones
- Access the app's preferences
- Set up countdowns
Basic Usage
ImmersiveTime displays the current time in your menu bar. The app is designed to be minimalist and unobtrusive, while providing powerful time zone management features.
Menu Bar Display
By default, ImmersiveTime displays the current time in your system's time zone in the menu bar. You can customize the format of this display in the app's preferences.
Main Menu
Clicking on the menu bar icon opens the main menu, which shows:
- Current time in your selected time zones
- Options to add or remove time zones
- Access to the floating clock feature
- Countdown options
- Preferences and settings
Managing Time Zones
Adding Time Zones
- Click on the ImmersiveTime menu bar icon
- Select "Add Time Zone" from the menu
- Search for a city or time zone name, or browse by region
- Click on the desired time zone to add it to your list
Removing Time Zones
- Click on the ImmersiveTime menu bar icon
- Right-click (or Control-click) on the time zone you want to remove
- Select "Remove" from the context menu
Reordering Time Zones
You can change the order of your time zones in the preferences:
- Click on the ImmersiveTime menu bar icon
- Select "Preferences" from the menu
- Go to the "Time Zones" tab
- Drag and drop time zones to reorder them
Floating Clock
The floating clock feature allows you to have a clock window that stays on top of other windows, making it easy to keep track of time while working.
Enabling the Floating Clock
- Click on the ImmersiveTime menu bar icon
- Select "Show Floating Clock" from the menu
Customizing the Floating Clock
You can customize the appearance and behavior of the floating clock:
- Click on the ImmersiveTime menu bar icon
- Select "Preferences" from the menu
- Go to the "Floating Clock" tab
- Adjust size, opacity, position, and other settings
Moving the Floating Clock
You can drag the floating clock to any position on your screen. The position will be remembered between app launches.
Countdown Feature
ImmersiveTime includes a countdown feature that allows you to track time until important events.
Creating a Countdown
- Click on the ImmersiveTime menu bar icon
- Select "Countdown" from the menu
- Choose "New Countdown"
- Enter a name for your countdown
- Set the target date and time
- Click "Create"
Using Preset Countdowns
ImmersiveTime includes preset countdowns for common holidays and events:
- Click on the ImmersiveTime menu bar icon
- Select "Countdown" from the menu
- Choose "Preset Countdowns"
- Select a preset from the list
Managing Countdowns
You can view, edit, and delete your countdowns:
- Click on the ImmersiveTime menu bar icon
- Select "Countdown" from the menu
- Choose "Manage Countdowns"
- From here, you can edit or delete existing countdowns
Preferences
ImmersiveTime offers various customization options through its preferences panel.
General Preferences
- Launch at login: Set ImmersiveTime to start automatically when you log in
- Time format: Choose between 12-hour and 24-hour time formats
- Show seconds: Toggle the display of seconds in the time
- Menu bar display options: Customize what information appears in the menu bar
Appearance
- Theme: Choose between light, dark, or system theme
- Custom colors: Set custom colors for various elements
- Background image: Add a custom background image
- Transparency and blur: Adjust the transparency and blur effects
Notifications
- Countdown notifications: Get notified when countdowns reach zero
- Time zone change notifications: Get notified about daylight saving time changes
- Custom alerts: Set up alerts for specific times
Keyboard Shortcuts
ImmersiveTime supports several keyboard shortcuts to enhance productivity:
| Action | Shortcut |
|---|---|
| Open main menu | ⌘+Shift+T |
| Show/hide floating clock | ⌘+Shift+F |
| Open preferences | ⌘+, |
| Add new time zone | ⌘+Shift+N |
| Create new countdown | ⌘+Shift+C |
| Quit application | ⌘+Q |
Troubleshooting
Common Issues
ImmersiveTime doesn't appear in the menu bar
Try these steps:
- Restart the application
- Check if you have too many menu bar items which might be causing some to be hidden
- Try restarting your Mac
Time zones are incorrect
Ensure your system time and time zone are set correctly. ImmersiveTime relies on your system's time settings as a reference.
Application crashes on startup
Try removing the application's preferences file:
- Open Finder
- Press ⌘+Shift+G
- Enter ~/Library/Preferences/
- Find and delete any files containing 'immersivetime' in their name
- Restart the application
Getting Help
If you're experiencing issues not covered here, please:
- Check the Support page for more information
- Contact us at contact@immersivetime.app