PurpleTube Player

A decentralized video launcher for PeerTube content, designed for digital freedom and ethical media access.

Table of Contents

• 📌 About
• ✨ Features
• 🛠 Technologies Used
• 📦 Installation
• 🚀 Usage
• 📝 License
• 🤝 Contributing
• 📧 Contact
• 🙏 Acknowledgments

---

📌 About

PurpleTube Player is an open-source application that allows users to search, organize, and watch videos from PeerTube, a decentralized video platform. It supports playlists, RSS feeds, and offline viewing, all while prioritizing privacy and user control.

↑ Back to top

✨ Features

• Search and Discover: Find videos using SepiaSearch integration
• Playlists: Create and manage custom playlists
• RSS Feeds: Subscribe to PeerTube channels and stay updated
• Offline Watching: Download videos for offline playback
• MPV Integration: Play videos with MPV (optional)

↑ Back to top

🛠 Technologies Used

Technology	Purpose
Python 3.8+	Core programming language
PyQt5	GUI Framework
SQLite	Database management
yt-dlp	Video downloading
SepiaSearch API	Video search functionality
Feedparser	RSS feed parsing
Requests	HTTP requests
BeautifulSoup	HTML parsing

↑ Back to top

📦 Installation

Prerequisites

• Python 3.8+
• pip (Python package manager)
• MPV (optional, for video reproduction on your local machine)

1. Clone the repository:

   git clone https://code.amassaro.com/angelo/purpletube.git
   cd purpletube
   
   

Quick Installation

Step 1: Download the installer script

Make sure you have quick_install.sh in your current directory.

Step 2: Make it executable

chmod +x quick_install.sh

Step 3: Run the installer

./quick_install.sh

Step 4: Run the application

python3 purpletube4.py

🚀 Usage

• Search Videos: Enter a search term in the search bar and press Enter or click Search. Results are fetched from SepiaSearch.

• Playlists: Create, edit, and delete playlists. Add videos to "Watch Later" or custom playlists.

• RSS Feeds: Add PeerTube channel RSS feeds to stay updated. Refresh feeds manually or automatically.

• Video Playback: Open videos in your default browser or MPV (if installed). Download videos for offline viewing.

• Settings: Choose between browser or MPV for playback. Clear user data if needed.

📝 License

This project is licensed under the GNU GPL v3 – see the LICENSE file for details.

📧 Contact

For questions or feedback, contact: Angelo Massaro – amassaro@boostmedia.it

🙏 Acknowledgments

SepiaSearch for video search functionality.

Mpv for their great video player.

PeerTube for decentralized video hosting.

BoostMedia APS for supporting open-source initiatives.