Skip to main content

timer

PyPI version Python version License Ruff

Discord timer bot. Feel free to use it in your server (click the link).

Self-hosting

Create an application in the Discord Developer Portal, copy its bot token, and invite it with the bot and applications.commands scopes. Then, with Python 3.13+:

pip install timer-bot
DISCORD_TOKEN=<token> PYTHONOPTIMIZE=1 timer-bot

PYTHONOPTIMIZE=1 is required: without it, /timer does not register globally. Running timers are saved to timers.json in STATE_DIRECTORY, or in the working directory if it is not set.

Notes

  • When down to a seconds countdown (<5min), the bot regularly skips a second. This is normal: Discord limits the rate of message updates to one per second so there is no way to have a clean and precise second-by-second countdown. Even if some seconds are skipped on the display, the total counter is precise and fair.

Metadata

Release files for timer-bot 1.12

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for timer-bot 1.12
File Size Uploaded
timer_bot-1.12.tar.gz 7.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for timer-bot 1.12
File Interpreter ABI Platform
timer_bot-1.12-py3-none-any.whl Python 3 none any Details

Total release size: 15.7 kB

Release files / timer_bot-1.12.tar.gz

Download URL timer_bot-1.12.tar.gz
Size 7.3 kB
Tags Source
SHA-256 checksum
How to use checksums
45a29d768852d6dc2e00a65b1a05e62b131cc5ba7ddec406d051bc88fca54130
BLAKE2b-256 checksum
How to use checksums
24280bb09b1c18568fcfe29282822079420e7c600aed9e7c40553c4b84b26b8f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / timer_bot-1.12-py3-none-any.whl

Download URL timer_bot-1.12-py3-none-any.whl
Size 8.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d70d32413ef591d42f6350dd01907488d74a473b2c92e1b8c4c69194e08389cb
BLAKE2b-256 checksum
How to use checksums
183afafe8879d949aafc6ced70c3c2e30f2a6d5a418bd670677a81a13be51d49
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

1.12 This release

2 release files

1.11

2 release files

1.10

2 release files

1.9

2 release files

1.8

2 release files

1.7

2 release files

1.6

2 release files

1.5

2 release files

1.4

2 release files

1.3

2 release files

1.2

2 release files

1.1

2 release files

1.0

2 release files

0.12

2 release files

0.11

2 release files

0.10

2 release files

0.9

2 release files

0.8

2 release files

0.7

2 release files

0.6

2 release files

0.5

2 release files

0.4

2 release files

0.3

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page