Introduction
Welcome to the Pomofy documentation. Pomofy is a powerful Discord bot that gamifies productivity through focus timers, task management, ambient music, study pets, and RPG-like progression.
Quick Start
Get up and running in less than a minute.
/timer start in a text channel./profile to check your stats and /shop browse to spend your coins.Focus Timer
The timer is the heart of Pomofy. It tracks your Pomodoro sessions, gives break reminders, and calculates rewards based on duration. You earn 10 PC per minute of focus.
You can also start group sessions that allow your friends to join and focus together, and use AI-powered prompts to set timers with natural language.
| Command | Description |
|---|---|
| /timer start [duration] | Start a focus session (default: 25 min). |
| /timer ai [prompt] | Start via natural language, e.g. "Study math for 45 mins". ✨ Premium |
| /timer stop | End your current session and save stats. |
| /timer pause | Pause the current timer. |
| /timer resume | Resume a paused timer. |
| /timer status | Check current timer status. |
| /timer quick | Instant 25-minute focus timer. |
| /timer group [duration] [task] | Start a group session others can join. |
Templates
Save your favorite focus configurations as reusable templates. Each template stores the focus duration, break duration, emoji, and a default task. Free users get 3 templates, Premium users get 25.
| Command | Description |
|---|---|
| /templates list | View your saved templates. |
| /templates create [name] [duration] [break] [emoji] [task] | Create a new template. |
| /templates start [name] | Start a timer from a saved template. |
| /templates delete [name] | Delete a template. |
Schedules
Set up recurring focus sessions that automatically remind you at specific times. Configure your timezone first with /settings. Free: 3 schedules, Premium: 15.
| Command | Description |
|---|---|
| /schedule create [name] [time] [duration] [days] | Create a recurring schedule. |
| /schedule list | View all your active schedules. |
| /schedule delete [name] | Remove a schedule. |
Focus Rooms
Focus Rooms are text channels that automatically lock when someone starts a timer, preventing distractions. They unlock when the timer ends. Free: 1 room, Premium: 10 rooms. Requires Manage Server permission to set up.
| Command | Description |
|---|---|
| /focusroom setup [channel] [autolock] | Configure a channel as a Focus Room. |
| /focusroom remove [channel] | Remove Focus Room configuration. |
| /focusroom list | View all Focus Rooms in the server. |
| /focusroom lock [channel] | Manually lock a Focus Room. |
| /focusroom unlock [channel] | Manually unlock a Focus Room. |
| /focusroom stats [channel] | View usage statistics for a Focus Room. |
Lofi Radio
24/7 high-quality lofi beats to help you focus. Pomofy joins your voice channel and plays curated stations. You can also set up a persistent player panel in a text channel for easy controls. Free: 2 stations, Premium: 8 stations.
| Command | Description |
|---|---|
| /lofi play [station] | Start playing a lofi station in your VC. |
| /lofi stop | Stop playback and leave the VC. |
| /lofi volume [level] | Adjust volume (0–100). |
| /lofi setup | Set up a persistent lofi player panel in a text channel. |
Soundscapes
Immersive ambient nature sounds for deep focus — rain, forest, ocean, campfire, and more. Plays in your voice channel alongside your session. Free: 2 scenes, Premium: 6 scenes.
| Command | Description |
|---|---|
| /soundscape play [scene] | Start an ambient soundscape in your VC. |
| /soundscape stop | Stop the soundscape. |
Task Management
Link specific tasks to your focus sessions for better tracking and XP bonuses. Completing a task gives extra PomoCoins. Free: 15 tasks, Premium: Unlimited.
| Command | Description |
|---|---|
| /task add [text] | Create a new to-do item. |
| /task list | View your pending tasks. |
| /task complete [id] | Mark a task as complete (XP bonus!). |
Reminders
Set personal reminders that DM you when the time is up. Supports relative times like 10m, 1h, 30s. Free: 5 reminders, Premium: 25 reminders.
| Command | Description |
|---|---|
| /remind [time] [message] | Set a reminder. E.g., /remind 1h Take a break |
Study Channels
Designate voice channels as Study Rooms. Time spent in these channels is tracked automatically (no timer needed), and you earn rewards passively. View weekly leaderboards for your study channels. Free: 2 channels, Premium: 10 channels.
| Command | Description |
|---|---|
| /study setup [channel] | Configure a VC as a Study Room (Admin). |
| /study remove [channel] | Remove a Study Room (Admin). |
| /study stats | View your personal study time. |
| /study leaderboard | View top students of the week. |
Economy System
PomoCoins are the currency of Pomofy. You earn 10 PC per minute of focus, plus bonuses for completing tasks and quests.
- Shop: Buy exclusive roles and consumable items like XP potions.
- Gifting: Send PomoCoins to other users.
- Leaderboard: Ranked by total focus time and wealth.
- Daily Rewards: Claim free coins every day (50 free, 100 premium).
| Command | Description |
|---|---|
| /shop browse | Browse and purchase exclusive roles. |
| /shop items | Browse consumables (potions, etc.). |
| /shop inventory | View your purchased items. |
| /shop gift [user] [amount] | Gift PomoCoins to another user. |
| /daily | Claim your daily coin reward. |
| /leaderboard [scope] | View top users (global or server). |
/shopadmin setup to create default shop roles, /shopadmin customize to rename roles, and /shopadmin reset to start over.Study Pets
Adopt a virtual study pet that grows alongside you! Pets gain XP when you focus, level up over time, and need to be fed to stay happy. Feed costs 50 PC. Choose from cats, dogs, owls, and foxes.
| Command | Description |
|---|---|
| /pet adopt [type] [name] | Adopt a new study pet (cat, dog, owl, fox). |
| /pet view | View your active pet's stats and mood. |
| /pet feed | Feed your pet to restore happiness (50 PC). |
Daily Quests
Complete daily quests to earn bonus PomoCoins. Quests refresh every day and include goals like "Focus for 30 minutes" or "Complete 3 tasks." Premium users get AI-generated personalized quests.
| Command | Description |
|---|---|
| /quests | View your current daily quests and progress. |
Analytics & Profile
Track your productivity with detailed stats. View your focus hours, daily streaks, session history, and more. The /profile command shows a comprehensive overview of your Pomofy journey. Premium users unlock full analytics, calendar view, and weekly reports.
| Command | Description |
|---|---|
| /profile [user] | View your (or another user's) productivity profile. |
| /stats | View your personal focus statistics. |
| /analytics | Detailed productivity insights. ✨ Premium |
| /calendar | Visual calendar of your focus history. ✨ Premium |
| /leaderboard [scope] | View global or server leaderboard. |
| /inspire | Get a random productivity quote. |
Settings
Customize your Pomofy experience. Configure notifications, timezone, weekly reports, and stealth mode.
| Setting | Options |
|---|---|
| Notifications | Server Channel (public) or Direct Message (private) |
| Timezone | Set your local timezone for schedules and reports |
| Weekly Report | Enable/disable weekly DM summary ✨ Premium |
| Stealth Timer | Hide remaining time from the timer embed ✨ Premium |
| Command | Description |
|---|---|
| /settings | Open your personal settings menu. |