Commit 8181d1
2025-07-06 22:24:48 Tebby Dog: Updated with Satire| /dev/null .. 2-code/docker/subway-surfers.md | |
| @@ 0,0 1,111 @@ | |
| + | # 🚄 Subway Surfers Text-to-Video Converter |
| + | Inspired by the absolute legend [danielbonkowsky/subwaysurfers-text](https://github.com/danielbonkowsky/subwaysurfers-text), this project throws some sauce on the original concept. If this container saves you time (or your sanity), go drop a star on his project already, damn it. |
| + | |
| + | ## 🚀 What the Hell Is This? |
| + | You ever try to focus on an article and your brain taps out after the second paragraph? Same. This little monster extracts text from a webpage and slaps it onto hyperactive **Subway Surfers** gameplay footage—turning dry, boring content into something your scrolling-addicted brain can actually sit through. Perfect for TikTok, ADHD, or just making studying suck less. |
| + | |
| + | You get: |
| + | 🧠 smart content + 🎮 mindless gameplay = ✅ actual retention (probably) |
| + | |
| + | ## 📸 Screenshot |
| + |  |
| + | |
| + | ## 🎯 Oh Hell Yeah, Features |
| + | - Converts your average web article into a **Subway Surfers-screaming-TikTok-style video** |
| + | - Rips text straight from URLs |
| + | - Slaps it on top of fast-ass gameplay |
| + | - Bonus points: **speech-to-text powered by Vosk API** |
| + | - Built with **Flask + OpenCV + goose3 + Python + zero chill** |
| + | |
| + | --- |
| + | |
| + | ## 🐳 Running This Beast with Docker |
| + | |
| + | **Step 1:** Pull the image, because we’re not building this crap from scratch: |
| + | ```sh |
| + | docker pull tebwritescode/subwaysurfers-text20:latest |
| + | ``` |
| + | |
| + | **Step 2:** Get the Vosk brain model and unzip it: |
| + | ```sh |
| + | wget https://alphacephei.com/vosk/models/vosk-model-en-us-0.22.zip |
| + | unzip vosk-model-en-us-0.22.zip -d ./ |
| + | rm vosk-model-en-us-0.22.zip |
| + | ``` |
| + | |
| + | **Step 3:** Drop a gameplay video into `./sources` — any `.mp4` will do. More videos = more fun. Only one? It'll reuse that sucker on every run. |
| + | |
| + | **Step 4:** Let’s ride: |
| + | ```sh |
| + | docker run -d --name subwaysurfers-text \ |
| + | -v ./subwaysurfers/sources:/app/sources \ |
| + | -v ./subwaysurfers/vosk-model-en-us-0.22:/app/static/vosk-model-en-us-0.22 \ |
| + | -p 5000:5000 \ |
| + | tebwritescode/subwaysurfers-text20:latest |
| + | ``` |
| + | |
| + | **Step 5:** Fire up your browser and hit: |
| + | ``` |
| + | http://localhost:5000 |
| + | ``` |
| + | |
| + | Get ready to weep tears of productivity as your article runs across a CGI train track. |
| + | |
| + | --- |
| + | |
| + | ## 🛠 Using Docker Compose Like a True King |
| + | Replace `<HOSTPATH>` with the full path to where your god-tier video and Vosk model live. |
| + | |
| + | ```yaml |
| + | services: |
| + | subwaysurfers-text: |
| + | image: tebwritescode/subwaysurfers-text20:latest |
| + | volumes: |
| + | - <HOSTPATH>/sources:/app/sources |
| + | - <HOSTPATH>/vosk-model-en-us-0.22:/app/static/vosk-model-en-us-0.22 |
| + | ports: |
| + | - "5000:5000" |
| + | ``` |
| + | |
| + | Start it up: |
| + | ```sh |
| + | docker-compose up -d |
| + | ``` |
| + | |
| + | Fun fact: if you only mount one `.mp4`, the app will always use that. Mount a folder of them? It picks a random vid each time. 🎲 |
| + | |
| + | --- |
| + | |
| + | ## 🐍 The Dockerfile Straight-Up Breakdown |
| + | |
| + | - Uses a slimmed-down official Python image |
| + | - Installs all the nasty dependencies (yes, even ffmpeg and build tools) |
| + | - Brings in Homebrew in case you're feeling fancy |
| + | - Copies the app, installs Python and brew packages |
| + | - Runs Flask like it means it |
| + | - Your container, your rules |
| + | |
| + | --- |
| + | |
| + | ## 🔮 Shit I Still Wanna Add |
| + | - Drop-down to select different AI voices (because not every AI wants to sound like Siri on Ambien) |
| + | - NVIDIA GPU acceleration (because some of you have beefy rigs) |
| + | - Fix that annoying subtitle-stuck bug nobody asked for |
| + | |
| + | --- |
| + | |
| + | ## 🧠 Want to Run It Without Docker? |
| + | You rebel. Here’s the repo for bare-metal installs: |
| + | 👉 https://github.com/tebwritescode/subwaysurfers-text-multi |
| + | |
| + | --- |
| + | |
| + | ## 🏆 Big-Ass Credit Section |
| + | Massive props to [danielbonkowsky](https://github.com/danielbonkowsky/subwaysurfers-text) for the core idea. This is just a remixed, Dockerized, slightly louder sibling. Go say thanks. |
| + | |
| + | --- |
| + | |
| + | ## ⚠️ Final Note from His Royal Freshness™ |
| + | Yeah, the container works. It does the job. But it's packing a little extra weight and could use a clean-up. If trimming containers gives you a tech boner, PRs are wide open. |
| + | |
| + | Enjoy learning like a hyper-caffeinated teenager on TikTok 🚀 |