dasemu/x-space-downloader
1
0
Fork 0
mirror of https://github.com/Dasemu/x-space-downloader.git synced 2026-10-13 21:49:45 +00:00
Code Issues Packages Projects Releases Wiki Activity

chore: polish repo for public release

Browse Source 
Add MIT LICENSE, fix README clone URL and add CI/license badges,
flesh out setup.py metadata, add a GitHub Actions test workflow,
and remove dead code left over from earlier iterations.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Darío Sevilla
2026-08-24 03:37:26 +02:00
parent b66b22923d
commit 0ca953cebc
7 changed files with 71 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
README.md
View File

@@ -1,5 +1,8 @@
# X Space Downloader
[![Tests](https://github.com/Dasemu/x-space-downloader/actions/workflows/tests.yml/badge.svg)](https://github.com/Dasemu/x-space-downloader/actions/workflows/tests.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
A Python CLI tool that downloads X (Twitter) Space recordings and renders an MP4 replay with audio and a compact participant view.
## Features
@@ -35,7 +38,7 @@ sudo apt install ffmpeg
### Install the tool
```bash
git clone https://github.com/synapz-org/x-space-downloader.git
git clone https://github.com/Dasemu/x-space-downloader.git
cd x-space-downloader
pip install -e .
```
@@ -68,6 +71,18 @@ x-space-dl --cookies cookies.txt https://x.com/i/spaces/1ZkKzZWnVRRKv
Cookies are also used to fetch the Space title, host, speakers, avatars, and replay chat timeline from X/Periscope metadata.
### Environment variables
Fetching metadata (required for the default video mode) needs a bearer token for X's web GraphQL API:
```bash
export X_BEARER_TOKEN="<token>"
```
Get this value from your own browser: open x.com while logged in, open DevTools → Network, and copy the `authorization: Bearer ...` header from any request to `x.com/i/api/graphql`. This is the public token issued to X's web client, not a personal secret, but it's not bundled with this tool — you provide your own.
`X_AUDIO_SPACE_QUERY_ID` can optionally override the GraphQL query ID used for `AudioSpaceById` if X changes it.
### Speaker timeline
With cookies, the tool automatically calls the replay `history` endpoint and builds participant/speaker timing from Space microphone events. If you already have speaker intervals from another extractor, you can override that with JSON: