beepex

Export Beeper chat history to static HTML, handy for archival purposes.

Example output can be seen here.

Initial setup

beepex requires running the Beeper desktop client and depends upon the Beeper Desktop API being enabled.

1. Enable the Beeper Desktop API
2. Create an access token and make note of it for future steps below.
   • It is convenient to name the token "beepex" and set it to non-expiring.
   • It is unnecessary to "Allow sensitive actions" (beepex is read-only and will not modify chats).

Installing beepex

Pre-built

Grab the latest pre-built release

Building manually

1. Install uv
2. Clone this repo (git clone https://github.com/johnburnett/beepex)
3. In the clone, either run build.sh to build a self-contained binary, or run uv run beepex.py to run without building

Running beepex

beepex needs to know the value of the access token created during initial setup above. It can be provided in a few ways, depending on your preferences:

1. Set an environment variable named BEEPER_ACCESS_TOKEN with the value of the access token above.
2. Saved in a file called .env file next to the beepex executable, containing BEEPER_ACCESS_TOKEN=YOUR_TOKEN.
3. Passed on the command line with the --token YOUR_TOKEN argument.

To export all chats to the directory C:\temp\beepex_export, run:

beepex.exe C:\temp\beepex_export