Contents
Screentime & Presence Statistics
The Screentime module gives every member a personal, visual summary of how much time they have spent active on Discord. Inspired by the classic year-in-review style recap, it posts a card with a clean weekly or daily chart directly in the channel.
Screentime is a passive feature with one condition: presence tracking is opt-in. Levlix only records the status changes of members who switched Presence Tracking on for themselves.
[!IMPORTANT]
Nothing is recorded until a member turns on Presence Tracking with /privacy or on the Privacy & Data page of the dashboard. Turning it off again deletes all of their recorded screen time at once.
Setup & Installation
Screentime needs no server setup beyond the module switch. Each member decides for themselves whether their presence is recorded: Presence Tracking is off until they turn it on, either with /privacy in Discord or on the Privacy & Data page of the web dashboard.
| Requirement | Details |
|---|---|
| Bot permissions | None beyond the defaults. The card is the reply to the command. |
| Member opt-in | Presence Tracking switched on by the member (/privacy or Privacy & Data). Counting starts within about five minutes, with the member's next status change. |
| Dashboard toggle | The Statistics module on the Modules page. While it is off, Levlix records no presence on that server and /screentime is not available there. A member who shares no other server with the module on stops being counted within five minutes. |
Because the data is based on public Discord presence (Online, Idle, Do Not Disturb, Offline), members with their status set to "Invisible" will not appear in their own charts during invisible periods. This is intentional and respects Discord's privacy expectations.
Screen time belongs to the member, not to a server: it counts their status across every server where the module is on, and the card shows the same numbers on each of them.
Using the Command
Any member can generate their own screentime chart at any time.
/screentime
Running the command posts a card in the channel. It speaks the server language and has two tabs:
| Tab | What it shows |
|---|---|
| Week | The last seven days broken down by day and status color, with your daily average and the change compared with the seven days before |
| Today | Today's activity broken down by hour, with your total so far and the change compared with yesterday |
The card shows the chart as an image and the key numbers as text. It includes every minute counted up to the moment you run the command. Everyone in the channel sees it, but only you can switch the tabs. In my language gives any reader a private text copy of the card in their own language; the copy carries the numbers but not the chart image.
The chart uses Discord's native status colors for the three statuses that count as active time:
| Status | Meaning |
|---|---|
| Online | Member was actively using Discord |
| Idle | Member was away but connected |
| Do Not Disturb | Member was connected but marked unavailable |
Offline time is not counted and does not appear in the chart.
Who Can Use It
| Action | Permission |
|---|---|
Run /screentime |
Any member |
| View another member's screentime | Not supported, charts are personal only |
| Delete personal screentime data | The member turns Presence Tracking off (/privacy or Privacy & Data), which deletes all of their screen time right away. Deleting the account removes it too. |
Only the member who runs the command can switch between Week and Today. Others who click a tab get a short private note instead.
How It Works
Screentime works in two steps:
- A lightweight presence tracker notices when an opted-in member's status changes and keeps the running minutes in memory.
- Every five minutes Levlix saves those minutes, grouped by day, hour, and status.
/screentimesaves the pending minutes first, so the card is up to date.
This design means the feature adds almost zero load per event, and a member's chart is always built from these totals rather than from a log of every status change.
Edge Cases & Important Notes
- Invisible status is not tracked. Discord reports an invisible member as Offline, so that time is not counted.
- Tracking is opt-in. Members who have not switched Presence Tracking on are never recorded. Their card stays empty and says how to turn tracking on.
- A member must be visible to Levlix. If Levlix does not share a server with the module on, or cannot see the member's presence for any reason, the stats will show gaps.
- The chart is personal. There is no leaderboard or comparison feature by design. Screentime is a self-reflection tool, not a ranking tool.
- Data retention. Presence minutes are kept for 90 days and then deleted automatically; the card itself only uses the last 14 days. Turning Presence Tracking off deletes everything recorded so far, and turning it on again starts from zero. See Data Retention & Privacy for all retention windows.
- Days and hours follow UTC. "Today" starts at midnight UTC, and the hours in the Today chart are UTC hours.
- Short periods are dropped. A status that lasts less than a minute is not counted, and partial minutes are rounded down.
Troubleshooting
My chart is mostly empty.
If the card says Presence Tracking is off, turn it on (/privacy or Privacy & Data): without it Levlix records nothing. If it is on, counting starts with your next status change after you turned it on, for example when you go idle or come back online. Allow about five minutes after switching it on, then use Discord as usual and try again.
My chart shows me Offline when I was active.
Check that your Discord status was not set to Invisible. Invisible members are never reported as online by Discord, so Levlix cannot track that time.
The tabs don't respond.
Only the member who ran the command can switch the tabs. If you clicked on someone else's card, run /screentime yourself and use your own card. The tabs also stop working after 10 minutes without a click; run the command again for a fresh card.
Related Features
- XP & Leveling - Voice time is also tracked by the XP system and rewards members with level progression.
- Activity Tracking - Message, voice, and reaction counts per member.
- Milestones - Use voice minutes and message counts to set community-wide goals.