A lightweight Flask app for splitting text into cards/pages and navigating them with a clean web or desktop interface.
pyCardShuffle is a minimal text navigation tool. Paste text, split it with ---, and move through the resulting cards/pages with next/previous controls. It can run locally in your browser or be built as a standalone desktop application with a single script.
- Insert text and auto-split into cards/pages with
---. - Navigate forward and backward through pages.
- Copy the full card text to clipboard with one click.
- Clean, responsive interface with modal input.
- Runs either as a local Flask web app or a desktop app via packaged build.
- Self-contained setup with helper scripts for web and desktop modes.
- Python 3.8 or newer installed.
- pip available for installing Python packages.
You have two options:
Option 1: Download from Releases
- Head to the Releases tab and download the latest ZIP for the web app.
- For the desktop app, download the prebuilt package directly from the Releases tab.
Option 2: Clone and Run from Source
- Clone the repository:
git clone https://github.com/Ventexx/pyCardShuffle.git
cd .\pyCardShuffle\- Start the app using the provided helper scripts. These scripts handle virtual environment creation and requirements installation automatically.
# Linux / macOS
chmod +x ./run_web.sh
./run_web.sh# Windows
run_web.bat- Open the app in your browser at:
http://127.0.0.1:8992/
If you want to package the desktop app yourself instead of downloading a prebuilt release:
# Linux / macOS
chmod +x ./build_desktop.sh
./build_desktop.sh# Windows
build_desktop.batTo completely remove the app, delete the repository folder. No data is stored outside of it.
Your contributions are welcome!
- Maintainer: Ventexx (ven.private@outlook.de)
pyCardShuffle © 2025 by Ventexx is licensed under CC BY-NC 4.0. To view a copy of this license, visit https://creativecommons.org/licenses/by-nc/4.0/