An open API service indexing awesome lists of open source software.

https://github.com/suresh-pyhobbyist/tubemanlive

TubeManLive: Your Secret Weapon for YouTube Live Streams! ๐Ÿš€
https://github.com/suresh-pyhobbyist/tubemanlive

moderator-tools youtube youtube-live youtube-live-bot youtube-stream youtuber

Last synced: 4 months ago
JSON representation

TubeManLive: Your Secret Weapon for YouTube Live Streams! ๐Ÿš€

Awesome Lists containing this project

README

          

# ๐Ÿš€ TubeManLive: Your Secret Weapon for YouTube Live Streams\! ๐Ÿš€

-----

Hey creators\! Ever wonder what your audience *really* thinks during your live streams? Drowning in chat messages trying to keep up? Well, say hello to **TubeManLive** โ€“ the ultimate sidekick for any serious YouTuber going live\!

This isn't just some boring app; it's your real-time **sentiment radar** for live chat. TubeManLive dives into your YouTube stream, pulls out every single chat message, and tells you the vibe of your community. Are they hyped? Are they confused? Are there a few bad apples spoiling the fun? TubeManLive tells you *instantly*.

## โœจ What Makes TubeManLive So Dope?

* **Live Chat Superpower:** It literally watches your live stream chat in real-time, grabbing every comment as it appears. No more guessing what's flying by\!
* **Vibe Check Master:** We're talking **instant sentiment analysis**. Every message gets a tag: **Positive** ๐ŸŸข (they love you\!), **Negative** ๐Ÿ”ด (uh oh, something's off\!), or **Neutral** โšช (just chilling).
* **Audience VIP List:** Not only does it tell you *what* people are saying, but it also tracks *who* is saying it. See your biggest fans and, well, those who might need a time-out.
* **Dashboard of Awesomeness:** Everything's laid out on a clean, real-time dashboard. Watch messages roll in, see the overall mood shift, and get a quick glance at your chat champions and villains.
* **Seriously Easy:** Copy a YouTube live URL, paste it in, hit "Start," and boom โ€“ you're a chat analysis pro.

-----

## ๐Ÿ”ฅ Why Every Live YouTuber NEEDS TubeManLive\!

Okay, so why is this not just cool, but *essential* for your live game?

* **Real-Time Audience Super-Sense ๐Ÿง :** Imagine knowing the exact moment your audience gets excited, bored, or even annoyed. TubeManLive gives you that sixth sense. Did a joke land? Is this topic a hit or a miss? You'll know immediately and can **adjust your content on the fly** to keep everyone engaged.
* **Your Personal Bouncer for Bad Vibes ๐Ÿšซ:** Live chat can get wild. Spam, trolls, negativity... it happens. TubeManLive acts like your personal bouncer, **highlighting problematic comments and authors in real-time**. This means you (or your mods) can take action way faster, keeping your chat a positive, welcoming space. No more wading through hundreds of messages to find the one causing trouble\!
* **Spotlight Your True Fans โœจ:** It's tough to see every "I love you\!" message in a fast-moving chat. TubeManLive helps you **identify your most positive and supportive viewers** instantly. Shout them out, engage with them, and build an even stronger community.
* **Level Up Your Content Game ๐Ÿ“ˆ:** Want to know what really resonates? TubeManLive's sentiment trends can show you. After the stream, you can look back and see what discussions generated the most positive buzz, helping you plan even better streams in the future.
* **Stress-Free Moderation ๐Ÿ˜Œ:** If you've got mods, TubeManLive makes their job a breeze. Instead of eyeballs glued to every word, they can focus on the flagged messages, making moderation more efficient and less stressful.

Simply put, **TubeManLive** turns your live chat into an actionable feedback loop, helping you run smoother, more engaging, and less stressful live streams. It's like having an audience analyst right there with you\!

-----

## ๐Ÿš€ Let's Get This Party Started\!

Ready to supercharge your live streams? Hereโ€™s how to get TubeManLive up and running:

Since you're using TubeManLive, the Chrome version being referred to is the one that TubeManLive interacts with.

You're using **Chrome version 137.0.7151.70** with TubeManLive.
Understood! So you're using a specific Chrome version for your testing.

Here's what you'll need, keeping it simple:

---

### ๐Ÿ“‹ What You'll Need

* **Python 3.x**: Get it from [python.org/downloads](https://www.python.org/downloads/).
* **Google Chrome Browser**: You need Chrome installed. Download it from [google.com/chrome](https://www.google.com/chrome/).
* **I'm using Chrome version 137.0.7151.70.**
* **ChromeDriver**: Since you're using Chrome version **137.0.7151.70**, you'll need the matching ChromeDriver.
* If you have **Selenium 4.6 or newer**, it should handle downloading the correct driver for you automatically.
* Otherwise, you'll need to manually download ChromeDriver version 137.0.7151.70 from [googlechromelabs.github.io/chrome-for-testing/](https://googlechromelabs.github.io/chrome-for-testing/).

### ๐Ÿ“ฆ Quick Setup

1. **Get the Code:**

```bash
git clone # Don't forget to replace this with your actual repo URL!
cd
```

2. **Spin Up a Virtual Environment (Smart Move\!):**

```bash
python -m venv venv
# On Windows: .\venv\Scripts\activate
# On macOS/Linux: source venv/bin/activate
```

3. **Install the Essentials:**
Create a file named `requirements.txt` in your main project folder and paste this inside:

```
Flask==2.3.3
selenium==4.22.0
webdriver-manager==4.0.1
spacy==3.7.4
nltk==3.8.1
```

Now, run this command:

```bash
pip install -r requirements.txt
```

4. **One-Time Downloads (Might Happen Automatically):**
TubeManLive might download some language data the first time you run it. If it gets stuck, you can manually trigger it:

```bash
# For NLTK's sentiment brain
python -c "import nltk; nltk.download('vader_lexicon')"

# For SpaCy's language model
python -m spacy download en_core_web_sm
```

5. **Folder Structure Check:**
Just make sure your project looks like this:

```
your_project_folder/
โ”œโ”€โ”€ app.py # This is the main brain!
โ”œโ”€โ”€ templates/
โ”‚ โ””โ”€โ”€ dashboard.html # Your awesome dashboard lives here
โ””โ”€โ”€ static/
โ”œโ”€โ”€ css/ # For future styling magic
โ””โ”€โ”€ js/ # For future interactive wizardry
```

Make sure you've got the `dashboard.html` file (from our previous chat) inside that `templates/` folder\!

-----

## ๐Ÿš€ Fire It Up\!

1. **Activate your virtual environment** (if you haven't already).
2. **Launch TubeManLive:**
```bash
python app.py
```
You'll see some techy messages, then look for:
```
* Running on http://127.0.0.1:5000
```
3. **Open your browser** and head to:
**`http://127.0.0.1:5000`**

-----

## ๐ŸŽฎ How to Play

1. **Grab a Live URL:** Find a YouTube live stream (must be *active* and live, not a past broadcast\!). Copy its URL.
2. **Paste & Go:** Paste that URL into the input box on the TubeManLive dashboard.
3. **Hit "Start Scraping":** Watch the magic happen\! The dashboard will start filling with live chat messages, color-coded by sentiment.
4. **Monitor & Mingle:** Keep an eye on the sentiment stats and author lists to get the pulse of your community.
5. **"Stop Scraping":** When you're done, just hit the stop button.

-----

## ๐Ÿ›‘ Powering Down

To shut down TubeManLive, just go back to your terminal where `app.py` is running and press `Ctrl + C`. Easy peasy.

-----

## ๐Ÿ› ๏ธ The Tech Behind the Magic

* **Python**: The main programming wizard.
* **Flask**: Our quick and easy web framework.
* **Selenium**: The robot that browses YouTube for us.
* **WebDriver Manager**: Makes sure Selenium always has the right browser driver.
* **NLTK (VADER)**: The sentiment sorcerer's secret spellbook.
* **SpaCy**: A powerful language processing library (always good to have for future upgrades\!).
* **HTML, CSS, JavaScript**: The ingredients for our snazzy web dashboard.