STDownloader

A sleek desktop application to download your favorite series from SeriesTurcasTv — automatically, efficiently, and right where you want them.

Overview

STDownloader is a cross-platform desktop application built with Electron Forge, React, and Vite that lets you effortlessly capture and download series chapters directly from SeriesTurcasTv. No more manual downloading — STDownloader automatically detects available chapters for a given series and queues them for download to a folder of your choice.

✨ Key Features

• 📺 Series Chapter Detection — Automatically fetches and lists all available chapters for any series on SeriesTurcasTv.
• ⬇️ Batch Chapter Downloads — Select individual episodes or download an entire series in one click.
• 🔄 Download Queue Management — Chapters are queued and downloaded sequentially with real-time progress tracking.
• 🖥️ Native Desktop Experience — Runs natively on Windows, macOS, and Linux via Electron.
• ⚡ Fast & Lightweight UI — Built with React and Vite for a snappy, responsive interface with near-instant hot reload in development.
• ⚙️ Persistent Settings — Your preferences (download path, quality options, etc.) are saved between sessions.

🚀 Technologies Used

Layer	Technology
Desktop Shell	Electron Forge
UI Framework	React
Build Tool	Vite
Language	JavaScript
Packaging	Electron Forge packager & makers

Getting Started

📦 Prerequisites

• Node.js v18 or higher
• npm v9+ or yarn

🔧 Installation

Clone the Repository

git clone https://github.com/FelixCodex/STDownloader.git
cd STDownloader

---

Install Dependencies

Using npm:

npm install

Using yarn:

yarn install

---

Running in Development

npm run start

This launches the Electron app with Vite's dev server and hot module replacement (HMR) enabled.

---

Building for Production

# Package the app for your current platform
npm run package

# Create distributable installers
npm run make

Built artifacts will be available in the out/ directory.

Usage

1. Launch STDownloader.
2. Open Add Series Modal by pressing the button named Add Series in the top-right.
3. Enter or paste the URL of a series from SeriesTurcasTv in the first input bar.
4. Specify a Download Folder if you haven't setted one in the settings.
5. STDownloader will fetch all available chapters automatically.
6. After all chapters are catched press the left-most button (Download Icon) in the series card to move it to the Downloader Queue.
7. Start the Download by pressing the Play button in the top-left.
8. Sit back and track progress — in real time.

📂 Project Structure

📦src
┣ 📂Components            # Reusable UI components
┃ ┗ 📂Icons               # React ready Icons
┣ 📂context               # React Context providers
┣ 📂hooks                 # Custom React hooks
┣ 📂infrastructure        # Backend app infrastructure features
┣ 📂reducers              # State reducers
┣ 📂shared                # Shared Utility files
┣ 📜App.jsx               # Root component
┣ 📜main.jx               # Main Application process
┣ 📜preload.jx            # Preload configs
┗ 📜renderer.jsx          # React Root renderer

Disclaimer

STDownloader is an independent, open-source project and is not affiliated with, endorsed by, or officially connected to SeriesTurcasTv. This tool is intended for personal use only.

⭐ If you find this project useful, please give it a star!

Made with ❤️ using Electron · React · Vite by FelixCodex