Version 1.0.0 Stable

BRING FOCUS TO
YOUR COMMUNITY.

Pomora is the first Voice-Automated Pomodoro bot. By automating the entire focus-break cycle through voice channel detection, we help study communities stay productive with minimal friction.

Installation & Setup

1. Invite & Authorize

Add Pomora to your server with the required permissions to manage voice and messages.

2. Mandatory Configuration

Pomora requires explicit designation of your study room to begin tracking sessions:

/config channels study target:#VoiceChannel

NOTE: Tracking will not start until this is set.

The Pomora Cycle

Once configured, Pomora operates with zero daily maintenance.

01

Seamless Activation

When the first student joins the configured channel, Pomora starts the focus timer immediately.

02

Focus & Break Transitions

Cycles through 50m Focus and 10m Break (default). Plays high-fidelity chimes and voice alerts during transitions.

03

Session Persistence

The timer continues until the current Focus or Break period ends, even if everyone leaves the room momentarily.

04

Smart Cleanup

If the room remains empty after a stage completes, the bot gracefully resets and waits for the next session.

Server Management

Admin Quick Configuration

Setup Voice Channel

/config channels study target:#channel

Setup Reports Channel

/config channels reports target:#channel

Setup Welcome Message

/config welcome channel target:#channel

Command Reference

CommandDescriptionAccess
/leaderboard [timeframe]Shows real-time server study rankings (Daily, Weekly, Monthly, All Time).Admin
/statusSync the active status card in the voice channel.Public
/statsView your personal study sessions and total hours.Public
/config channels studySet the main voice channel for Pomora to track.Admin
/config channels reportsSet the text channel for daily/weekly reports.Admin
/config welcome channelSet the channel for welcome messages.Admin
/helpView all available commands.Admin

Common Questions

Why isn't the bot working in my VC?

Ensure you have used /config channels study #channel. Pomora strictly monitors explicitly configured channels for precision tracking.

Do members keep their time if they disconnect?

Yes. Pomora logs session data every time a stage (Focus/Break) completes, either when the timer ends or when you leave.

What is Ghost Session?

If everyone leaves the voice channel, the timer CONTINUES running until the current stage ends (e.g. 25m Focus), allowing you to rejoin without losing progress.