https://github.com/youg-o/streamwarden

GUI desktop app that automatically monitors Twitch / YouTube / Kick channels and records livestreams as soon as they go live.
https://github.com/youg-o/streamwarden

auto-recording downloader gui kick recorder streamlink twitch youtube

Last synced: 8 months ago
JSON representation

GUI desktop app that automatically monitors Twitch / YouTube / Kick channels and records livestreams as soon as they go live.

• Host: GitHub
• URL: https://github.com/youg-o/streamwarden
• Owner: YouG-o
• License: agpl-3.0
• Created: 2025-08-27T09:23:47.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2025-09-10T04:56:58.000Z (8 months ago)
• Last Synced: 2025-09-10T08:35:17.014Z (8 months ago)
• Topics: auto-recording, downloader, gui, kick, recorder, streamlink, twitch, youtube
• Language: Java
• Homepage:
• Size: 152 KB
• Stars: 4
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
###



![StreamWarden icon](./assets/images/app_icon.png)

# StreamWarden : Auto Stream Recorder

Desktop app to automatically monitor Twitch / YouTube / Kick channels and record livestreams as soon as they go live.



###



## ⚠️ Early Development Warning

**This application is currently in early development and has not had its first official release yet.**

While you can build and run the application in its current state, it contains only the basic minimum features for stream monitoring and recording. The functionality works but the user experience is still rough around the edges.

**Use at your own discretion** - expect bugs, missing features, and potential breaking changes.



###



  ## Features:



  

- **Multi-Platform Support**: Monitor Twitch, YouTube and Kick channels simultaneously

- **Automatic Detection**: Start recording immediately when streams go live

- **Custom Quality Settings**: Choose recording quality per channel (best, 1080p, 720p, etc.)

- **Organized Storage**: Recordings are automatically sorted by channel in separate folders

- **Cross-Platform**: Works on Windows and Linux with automatic tool detection




The application uses Streamlink under the hood for reliable stream capture and supports automatic monitoring with customizable check intervals.

![App screenshot](./assets/images/app_screenshot.png)



###



  

  # Build it yourself




  For now, the only way for you to run the app is to build it yourself: 

  ### Prerequisites

  - Java 17 or higher

  - Maven 3.6+

  - **Streamlink** installed on your system (7.3.0 or higher for Kick support) (tested on 7.6.0)

  - **Python**

  ### Installation

  ```bash

  # Clone the repository

  git clone https://github.com/YouG-o/StreamWarden.git

  cd StreamWarden

  ```

  ```bash

  # FOW WINDOWS USERS : You can download portable Streamlink and extract into bin/windows, and this way, avoid having streamlink and/or python installed globally

  mkdir -p bin/windows

  curl -L -sS -o /tmp/streamlink.zip "https://github.com/streamlink/windows-builds/releases/download/7.6.0-1/streamlink-7.6.0-1-py313-x86_64.zip" && unzip -q /tmp/streamlink.zip -d bin/windows && rm -f /tmp/streamlink.zip

  ```

  ```bash

  # Build the application

  mvn clean javafx:run

  ```

###



  

  # Contributors:

  


  Contributions are welcome! Whether you want to fix bugs, add features, or improve documentation, your help is appreciated.



###



  

  # Support This Project


  


This application is completely free and open-source. If you find it valuable, you can support its development with a pay-what-you-want contribution!






  [![Support me on Ko-Fi](./assets/images/support_me_on_kofi.png)](https://ko-fi.com/yougo)

    

  [![Support with Cryptocurrency](https://img.shields.io/badge/Support-Cryptocurrency-8256D0?style=for-the-badge&logo=bitcoin&logoColor=white)](https://youtube-no-translation.vercel.app/?donate=crypto)






You can also support this project by:

- Starring this repository

- Sharing it with others who might find it useful

- Following me on [GitHub](https://github.com/YouG-o)

###



# Legal Notice ⚠️

**Important:** Before recording any stream, make sure you have the creator's permission or that the content is not protected by copyright.

Always respect the terms of service of streaming platforms (Twitch, YouTube, etc.).

This software is provided for educational and personal use only. I do not encourage copyright infringement and cannot be held responsible for improper use of this application.

# LICENSE

This project is licensed under the [GNU Affero General Public License v3.0](LICENSE)