A cinematic, Apple TV-inspired web application for finding and downloading entire TV shows & movies in a single click.

Key Features • Quick Start • Design System • Architecture • Русская версия • License

---

✨ Overview

AuraPlayer bridges the gap between chaotic media tracker indexes and the seamless elegance of Apple TV+. Built from the ground up adhering to Apple's Human Interface Guidelines (HIG), it eliminates the tedious routine of hunting down individual episodes, matching subtitle tracks, or managing fragmented torrent files.

Search any show or movie, hit «⚡ Download Full Series», and let AuraPlayer package all seasons directly to your local drive.

---

⚡ Key Features

1. 🎬 1-Click Season Packaging

• No more downloading 60 individual files for a multi-season series.
• Smart parsing identifies complete box sets ([S01-08], All Seasons 1-5, Complete Series).
• Highlights the healthiest, highest-bitrate release automatically in a prominent hero showcase.

2. 🍎 Authentic Apple Design System

• OLED Pitch Black (#000000) & Deep Canvas: Zero light pollution, matching tvOS and Apple TV Web design.
• Liquid Glassmorphism: Translucent floating navbars and modal sheets using native CSS backdrop-filter: blur(40px).
• HIG Ergonomics: Every interactive touch target strictly adheres to the $\ge 44 \times 44$ pt minimum tap area rule.
• Apple Typography: Fluid hierarchy powered by -apple-system, BlinkMacSystemFont, "SF Pro Display", "SF Pro Text".

3. 🚀 Built-in WebTorrent Engine + Native Finder

• Download directly in the browser via Node.js WebTorrent background workers.
• Live HUD: real-time transfer rates (MB/s), peer counter, elapsed time, and interactive progress bars.
• One-Click Finder Reveal: Instant button to open ~/Downloads/AuraPlayer/<Show_Name>/ directly in macOS Finder.
• External Client Handoff: Prefer Transmission, qBittorrent, or Folx? Launch magnet links instantly with zero friction.

4. 🧠 Intelligent Audio & Quality Detection

• Automatically detects and tags video qualities: 4K UHD, 1080p Full HD, 720p HD.
• Flags popular dubbing studios and voiceover tracks (LostFilm, HDRezka, Кубик в Кубе, Дубляж, Goblin).
• Real-time seeders/leechers health check with color-coded badges.

5. 🛡️ Built-in Image & Data Proxy

• Built-in server proxy with referrer manipulation to overcome anti-hotlinking shields (FastPic, ImageBan, HostingKartinok).
• High-resolution posters and fan art load seamlessly without broken thumbnails.

---

🚀 Quick Start

Prerequisites

• Node.js v18.0.0 or higher
• macOS, Linux, or Windows (macOS recommended for native Finder integration)

Installation

# 1. Clone the repository
git clone https://github.com/ElDAROOS/AuraPlayer.git

# 2. Navigate to project folder
cd AuraPlayer

# 3. Install dependencies
npm install

# 4. Launch AuraPlayer
npm start

Or simply run the automated bootstrap script on macOS/Linux:

chmod +x run.sh
./run.sh

AuraPlayer will automatically open in your default browser at: 👉 http://localhost:3333

---

🎨 Apple Design Principles

AuraPlayer strictly follows Apple Human Interface Guidelines:

Principle	Implementation
Minimum Hit Targets	All action buttons, chips, and controls exceed the 44×44pt requirement.
Visual Hierarchy	Featured season highlighted in top hero slot; secondary releases nested in clean shelves.
Material & Blur	Layered dark blur surfaces (rgba(28, 28, 30, 0.72)) with subtle 0.5px border strokes.
Fluid Motion	Cubic-bezier spring transitions (cubic-bezier(0.25, 1, 0.5, 1)) for buttery 60/120fps interactions.

---

📂 Directory & Download Location

Downloaded media files are organized into structured directories:

~/Downloads/AuraPlayer/
 └── Breaking Bad (Season 1-5 Complete) [1080p] [LostFilm]/
      ├── Season 01/
      ├── Season 02/
      └── ...

---

🛠️ Tech Stack

• Backend: Node.js, Express, WebTorrent, Axios, Cheerio
• Frontend: Vanilla JavaScript (ES Modules), CSS3 Glassmorphism, Semantic HTML5
• Design Language: Apple Human Interface Guidelines (macOS Sequoia / Sonoma / tvOS)
• Fonts: SF Pro Display, SF Pro Text

---

🇷🇺 Русская версия

Нажмите, чтобы прочитать описание на русском

О проекте

AuraPlayer — веб-приложение для мгновенного поиска и пакетного скачивания сериалов и фильмов в 1 клик, выполненное по стандартам Apple Human Interface Guidelines.

Особенности

• Пакетная загрузка целого сериала: автоопределение полных раздач всех сезонов — больше не нужно собирать серии по одной.
• Встроенный загрузчик: скачивание прямо через встроенный движок WebTorrent с прогрессом, скоростью и количеством пиров.
• Дизайн Apple TV: глубокий чёрный фон, блюр-эффекты матового стекла, системные шрифты Apple и эргономичные кликабельные зоны от 44pt.
• Интеграция с Finder: открытие папки со скачанным материалом в macOS в один клик.
• Поддержка внешних торрент-клиентов: мгновенная передача magnet-ссылки в Transmission, qBittorrent или Folx.

Запуск

./run.sh
# или
npm start

Интерфейс доступен по адресу: http://localhost:3333

---

🤝 Contributing

Contributions, issues, and feature requests are welcome!
Feel free to check the issues page.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📄 License

Distributed under the MIT License. See LICENSE for more information.

Crafted with care following Apple Human Interface Guidelines 