Skip to main content

​
Overview

Meelio provides extensive customization options organized into several categories. Access settings by clicking the settings icon in the dock or using the keyboard shortcut.
All settings are saved locally in your browser and persist across sessions.

​
Settings Categories

Meelio’s settings are organized into the following tabs:

General

Core application behavior and display preferences

Appearance

Theme selection and visual customization

Language

Interface language settings

Dock

Customize which features appear in your dock

Bookmarks

Browser bookmarks integration (extension only)

Data

Export, import, and manage your data

​
General Settings

Control the core behavior of Meelio’s features.

​
Mantra Rotation

Automatically rotate through different inspirational mantras and quotes on your home screen. 
// General Settings → Mantra Rotation
mantraRotationEnabled: boolean

​
Wallpaper Rotation

Automatically change your background wallpaper at regular intervals to keep your workspace fresh.

​
Confetti Celebration

Show a celebratory confetti animation when you complete a Pomodoro timer session.
Enable this setting to get a motivating visual reward when completing focus sessions!

​
Clock Format

Switch between 12-hour and 24-hour time display formats.
Display time in AM/PM format (e.g., 2:30 PM)

​
Reset Onboarding

Restart the onboarding tutorial to review Meelio’s features and functionality.

​
Timer & Pomodoro Settings

Customize your focus sessions with flexible timer configuration.

​
Duration Settings

Set the duration for your Pomodoro focus sessions.
  • Range: 1 to 1440 minutes
  • Default: 25 minutes
  • Recommended: 25-50 minutes for optimal focus
focusTime: number // in minutes (1-1440)
Configure the length of your break periods between focus sessions.
  • Range: 1 to 1440 minutes
  • Default: 5 minutes
  • Recommended: 5-15 minutes for short breaks
breakTime: number // in minutes (1-1440)

​
Notifications

Timer Notifications

Receive browser notifications when your timer completes.Note: Requires browser notification permissions.

Notification Sounds

Play an audible alert when timers complete.Requires notifications to be enabled.

​
Sound Options

Timer Sound Selection
Choose from multiple notification sounds:
  • Back Chime
  • Meditation Bell
  • Soft Ding
  • And more…
Click the preview button to test each sound before selecting it.

​
Ambient Features

Automatically play ambient sounds during focus sessions to enhance concentration.When enabled, your selected soundscape will start playing automatically when you begin a Pomodoro session.
soundscapes: boolean // default: true
Automatically begin break periods when a focus session completes, creating a seamless workflow.
autoStartBreaks: boolean // default: true

​
Dock Settings

Customize which productivity features appear in your dock for quick access.

​
Show Icon Labels

Display text labels beneath dock icons for easier identification.

​
Dock Features

Toggle visibility for each feature in your dock:
1

Timer (Pomodoro)

Access the Pomodoro timer for focused work sessions
2

Soundscapes

Browse and play ambient sounds for concentration
3

Breathing Exercises

Quick access to guided breathing techniques
4

Tasks

Manage your to-do lists and task organization
5

Notes

Create and edit quick notes
6

Site Blocker

Block distracting websites during focus time
7

Tab Stash

Save and restore browser tab sessions
8

Calendar

View your calendar and upcoming events
9

Backgrounds

Change your workspace wallpaper
10

Clock

Display world clocks and timezones
Each dock feature can be independently shown or hidden based on your workflow needs.

​
Bookmarks Settings

Bookmarks settings are only available in the browser extension version of Meelio.

​
Bookmarks Permission

Grant Meelio permission to access your browser bookmarks for quick access. Features:
  • Sync button to refresh bookmarks from your browser
  • Display count of synced bookmarks
  • Last sync timestamp

​
Display Options

Show bookmarks in a horizontal bar at the top of the page for instant access to your favorite sites.

​
Language Settings

Switch Meelio’s interface language to your preferred option. Meelio supports multiple languages with full internationalization.

​
Best Practices

  • Set timer durations that match your natural focus rhythm
  • Enable ambient soundscapes for deeper concentration
  • Use site blocker during Pomodoro sessions
  • Enable auto-start breaks to maintain rhythm
  • Hide features you don’t use regularly
  • Keep frequently used tools visible
  • Enable icon labels if you’re new to Meelio
  • Organize your workflow with strategic feature placement
  • Export your data regularly (see Data Settings)
  • Test import/export before relying on it
  • Keep backups of exported JSON files
Experiment with different settings to find what works best for your productivity style. Settings can be changed at any time without losing your data.

Build docs developers (and LLMs) love

Get started for freeTalk to us