OpenPlex

KO | EN

gitlite — search

#claude #react-native #privacy #ai-agent #graphql #css #agent #developer-tools #animation #framework

(★ 9)

A self-hosted media server with library browsing, AI chat, multi-source downloads, and a built-in movie catalog. Powered by FastAPI.

파일 탐색기

ZIP 다운로드

- - 93acabb1e890_initial_schema.py
- env.py
- README
- script.py.mako
- - __init__.py
  - catalog_favorite.py
  - download_catalog.py
  - download_task.py
  - file_category.py
  - user.py
  - watch_history.py
- - __init__.py
  - ai.py
  - auth.py
  - browse.py
  - catalog.py
  - chat.py
  - downloads.py
  - health.py
  - history.py
  - library.py
  - media.py
  - metrics.py
  - settings.py
  - status.py
- - __init__.py
  - agnes_ai.py
  - ai_service.py
  - azfilm_scraper.py
  - base_scraper.py
  - cache.py
  - catalog_enricher.py
  - catalog_serializer.py
  - catalog_updater.py
  - downloader.py
  - fanart.py
  - file_categorizer.py
  - local_ai.py
  - metadata.py
  - metadata_enricher.py
  - myf2m_scraper.py
  - omdb.py
  - opensubtitles.py
  - rate_limiter.py
  - scraper.py
  - scraper_registry.py
  - subtitle_service.py
  - thumbnail.py
  - tmdb.py
  - tmdb_enricher.py
  - tvdb.py
- __init__.py
- config.py
- database.py
- dependencies.py
- main.py
- openplex.service
- install.sh
- run.ps1
- run.sh
- - avatar-1.svg
  - avatar-10.svg
  - avatar-11.svg
  - avatar-12.svg
  - avatar-13.svg
  - avatar-14.svg
  - avatar-15.svg
  - avatar-2.svg
  - avatar-3.svg
  - avatar-4.svg
  - avatar-5.svg
  - avatar-6.svg
  - avatar-7.svg
  - avatar-8.svg
  - avatar-9.svg
- - api.js
  - health.js
  - main.js
  - router.js
  - svg.js
  - toast.js
- download-manager.js
- effects.css
- favicon.svg
- icon-192.png
- icon-192.svg
- icon-512.png
- icon-512.svg
- index.html
- library.js
- manifest.json
- nav.js
- player.js
- profile.js
- script.js
- style.css
- sw.js
- toast.js
- upload.js
- chat.html
- downloads.html
- error.html
- health.html
- index.html
- library.html
- login.html
- profile.html
- register.html
- settings.html
- status.html
- upload.html
- __init__.py
- conftest.py
- test_api_endpoints.py
- test_azfilm_api.py
- test_azfilm_scraper.py
- test_base_scraper.py
- test_donyayeserial_scraper.py
- test_download_routes.py
- test_download_task_model.py
- test_scraper_registry.py
.dockerignore
.env.example
.gitignore
alembic.ini
CONTRIBUTING.md
docker-compose.yml
Dockerfile
LICENSE
Makefile
pyproject.toml
README.md
requirements-dev.txt
requirements.txt
ROADMAP.md
STATUS.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A self-hosted media server with library browsing, AI-powered chat, download management, and multi-source content discovery.

![Python](https://img.shields.io/badge/Python-3.10+-blue?logo=python)
![FastAPI](https://img.shields.io/badge/FastAPI-0.115+-009688?logo=fastapi)
![License](https://img.shields.io/badge/License-MIT-green)
![Docker](https://img.shields.io/badge/Docker-Ready-2496ED?logo=docker)
[![Roadmap](https://img.shields.io/badge/roadmap-v2.2-blue)](https://raw.githubusercontent.com/Rfannn/OpenPlex/main/ROADMAP.md)
[![Status](https://img.shields.io/badge/status-beta-yellow)](https://raw.githubusercontent.com/Rfannn/OpenPlex/main/STATUS.md)

## Features

- **Netflix-style Library** — Hero banner, genre rows, continue watching, TMDB trending
- **AI Chat Assistant** — Agnes AI primary with local llama-server fallback
- **Download Manager** — aria2-powered with SSE progress, scheduling, speed limits
- **Multi-source Catalog** — DonyayeSerial, AzFilm, MyF2M scrapers with health monitoring
- **Media Player** — Custom player with subtitle support, transcoding, resume playback
- **File Browser** — Grid/list views, search, upload, rename, context menus
- **Metadata Enrichment** — TMDB, OMDb, Fanart.tv, TVDb integration
- **Subtitle Search** — OpenSubtitles + sub-plus.ir auto-fetching
- **PWA Support** — Installable, offline-capable service worker
- **Mobile Responsive** — Bottom tab navigation, touch gestures
- **Settings Dashboard** — Edit all API keys, AI config, scraper settings

## Quick Start

### Docker (Recommended)

```bash
git clone https://github.com/Rfannn/OpenPlex.git
cd OpenPlex
cp .env.example .env
# Edit .env with your API keys
docker compose up -d
```

### Manual Setup

```bash
git clone https://github.com/Rfannn/OpenPlex.git
cd OpenPlex
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# Edit .env with your settings
make run
```

Open http://localhost:8185

## Configuration

Copy `.env.example` to `.env` and configure:

| Variable | Required | Description |
|----------|----------|-------------|
| `SECRET_KEY` | Yes | Random secret for JWT tokens |
| `MEDIA_ROOT` | Yes | Path to your media files |
| `AGNES_API_KEY` | Recommended | Agnes AI for chat features |
| `TMDB_API_KEY` | Optional | Movie/TV metadata |
| `OMDB_API_KEY` | Optional | Backup metadata source |
| `FANART_API_KEY` | Optional | High-res artwork |
| `TVDB_API_KEY` | Optional | Enhanced TV metadata |
| `OPENSUBTITLES_API_KEY` | Optional | Auto subtitle fetching |

Full configuration available in the **Settings** page at `/settings`.

## API Endpoints

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/auth/register` | POST | Create account |
| `/api/auth/login` | POST | Get JWT token |
| `/api/library/rows` | GET | Netflix-style rows |
| `/api/library/search` | GET | Search catalog |
| `/api/catalog-search` | GET | Search local + scrapers |
| `/api/downloads` | GET/POST | Download management |
| `/api/chat/stream` | GET | AI chat (SSE) |
| `/api/subtitles/search` | GET | Find subtitles |
| `/api/settings` | GET/POST | Server settings (admin) |
| `/api/health/detailed` | GET | Health checks |

Full API docs at `/docs` (Swagger UI).

## Tech Stack

- **Backend**: FastAPI, SQLAlchemy (async), SQLite, aria2c
- **Frontend**: Vanilla JS, CSS custom properties, PWA
- **AI**: Agnes AI (primary), llama-server (fallback)
- **Metadata**: TMDB, OMDb, Fanart.tv, TVDb
- **Deployment**: Docker, systemd

## Project Structure

```
OpenPlex/
├── app/
│   ├── main.py           # FastAPI app, middleware, lifespan
│   ├── config.py          # Pydantic settings
│   ├── database.py        # SQLAlchemy async engine
│   ├── dependencies.py    # Auth, JWT
│   ├── models/            # ORM models
│   ├── routers/           # API endpoints
│   └── services/          # Business logic
├── static/                # CSS, JS, icons
├── templates/             # Jinja2 HTML
├── tests/                 # Pytest tests
├── deploy/                # systemd service
├── Dockerfile
├── docker-compose.yml
├── Makefile
└── pyproject.toml
```

## Contributing

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing`)
3. Commit changes (`git commit -m 'Add amazing feature'`)
4. Push to branch (`git push origin feature/amazing`)
5. Open a Pull Request

## License

MIT License — see [LICENSE](LICENSE) for details.

OpenPlex

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README