Flow State CLI

Play a random album from the Flow State newsletter collection — perfect music for focused work.

Installation

# Clone the repo
git clone https://github.com/cyphalle/flowstate-cli.git
cd flowstate-cli

# Install dependencies
pip install -r requirements.txt
playwright install chromium

# Build the album database (takes ~45 min, but can be interrupted/resumed)
python scraper.py

# Add to your shell
echo "alias flowstate=\"$(pwd)/flowstate\"" >> ~/.zshrc
source ~/.zshrc

Usage

flowstate

That's it. A random album opens in Spotify.

Update with latest issues

flowstate-update

This fetches new articles from the newsletter and adds them to your local database. Progress is saved, so you can interrupt and resume anytime.

🎵 Mighty Vertebrate
   from: Anna Butterss

How it works

1. The scraper fetches all free articles from Flow State's sitemap
2. It extracts Spotify album links from each article
3. The CLI picks one at random and opens it in Spotify

Requirements

• Python 3.10+
• Spotify desktop app
• macOS, Linux, or Windows

License

MIT