Skip to content

x0doit/asoplay

BranchesTags

Repository files navigation

AsoPlay

Status Backend Frontend Database License

Язык: Русский | English

AsoPlay — сервис для просмотра аниме с каталогом тайтлов, поиском, SEO-страницами, AsoPlayer, личными списками, прогрессом просмотра, публичными профилями и интеграцией с AnimeSocial. Фронтенд написан на vanilla JavaScript, бэкенд работает на Python/FastAPI, а пользовательские данные хранятся в MySQL.

Copyright © Чепела Даниэль Максимович (x0doit). Все права защищены. Репозиторий не является open source. Любое использование требует прямого письменного разрешения правообладателя.

Содержание

Возможности

  • Каталог и поиск на базе данных Jikan, AniList и Shikimori.
  • Страницы тайтлов /anime/{mal_id}-{slug}/ с мета-тегами на стороне сервера, Open Graph, JSON-LD, canonical URL, sitemap и <noscript> fallback для просмотра без JavaScript.
  • AsoPlayer с несколькими источниками, резервным поиском по доступным провайдерам, быстрыми скриншотами, фирменным контекстным меню и безопасной обработкой iframe postMessage.
  • AsoPlay Shield: same-origin player proxy, request-level filtering, runtime AdGuard-backed правила, popup/navigation hardening и аккуратная работа с sandbox iframe.
  • Интеграция AnimeSocial: авторизация через существующую MySQL-базу AnimeSocial и локальные HTTP-only сессии проекта.
  • Личный кабинет: избранное, продолжить просмотр, списки, статусы, оценки, выбранные озвучки, настройки и приватность.
  • Автоматические статусы списков: auto-watching, auto-completed и stale auto-dropped на основе реального прогресса просмотра.
  • Реальная логика просмотра: прогресс фиксируется по событиям плеера, а не по времени нахождения на странице.
  • Публичные профили со списками, которые учитывают настройки приватности, и графиком активности.
  • Прокси, health-state и кэш во время работы для внешних API, источников видео, данных и изображений.
  • Опциональный xray/Shadowsocks bridge для окружений, где внешние anime API недоступны напрямую.

AsoPlayer и Shield

AsoPlayer — это не отдельная библиотека, а прикладной player-слой проекта: страница управляет выбором источника, прогрессом, автопереходом серий, контекстным меню и пользовательскими действиями, а iframe-bridge отвечает за безопасную связь с фактическим плеером.

Ключевые возможности:

  • Контекстное меню по правому клику: Сделать скриншот, Копировать ссылку на аниме, Аниме соц сеть.
  • Быстрые PNG-скриншоты текущего кадра с чистыми именами файлов: AsoPlay-{mal_id}-ep{episode}-{hh}-{mm}-{ss}.png.
  • Отдельный Kodik skin в assets/player/kodik-skin.css с фирменным акцентом #ff6666.
  • Same-origin player proxy для iframe и media URL.
  • AsoPlay Shield для фильтрации рекламных URL, блокировки popup/navigation сценариев и защиты от шумных third-party scripts внутри sandbox.
  • Отдельные служебные player-ресурсы: /player/asoplay-shield.js, /player/kodik-skin.css, /player/frame, /player/proxy, /player/cvh-api/*.

Архитектура

.
├── index.html                  SPA shell и SSR placeholders
├── app.js                      публичный router, каталог, тайтл, player
├── styles.css                  дизайн-система приложения
├── assets/                     статические media assets
│   └── player/
│       └── kodik-skin.css      AsoPlayer/Kodik visual skin
├── js/
│   └── account.js              auth UI, личные разделы, store, профили
├── server/
│   ├── main.py                 FastAPI wiring, static serving, sources
│   ├── animesocial.py          AnimeSocial DB auth bridge и sessions
│   ├── animesocial_config.py   AnimeSocial URL/media configuration
│   ├── account_api.py          account compatibility API
│   ├── adblock.py              AdGuard-backed request filtering
│   ├── user_lists.py           list/status/favorite domain и auto-rules
│   ├── activity_log.py         contribution/activity event log
│   ├── profile_pages.py        public profile API и SSR shell
│   ├── title_pages.py          canonical anime pages, sitemap, robots
│   ├── proxies.py              Jikan/AniList/Shiki/translate/image proxies
│   ├── player_proxy.py         same-origin player proxy, Shield, iframe bridge
│   ├── source_health.py        source failure/cooldown state
│   ├── vpn_bridge.py           optional xray runtime bridge
│   ├── animevost.py            native AnimeVost source adapter
│   ├── oldyummy.py             native old.yummyani source adapter
│   └── requirements.txt        Python runtime dependencies
├── sql/
│   ├── aviev-schema.sql        базовая схема aviev_*
│   └── aviev-schema-pass2.sql  списки, приватность, активность, compatibility
├── animesocial.json            public URL/media mapping для AnimeSocial
├── animesocial-db.php          формат DB-конфига AnimeSocial
├── vpn.template.json           шаблон xray-конфига
├── .env.example                шаблон environment variables
├── COPYRIGHT                   proprietary copyright notice
└── .gitignore                  ignored local/runtime artifacts

Стек

  • Frontend: HTML, CSS, vanilla JavaScript ES modules.
  • Backend: Python 3.11+, FastAPI, Uvicorn, httpx.
  • Database: MySQL 8 / OpenServer-compatible AnimeSocial database.
  • Auth: существующая users-таблица AnimeSocial + локальные aviev_sessions.
  • Metadata: Jikan, AniList, Shikimori.
  • Player layer: same-origin iframe/media proxy, sandbox bridge, request-level ad filtering.
  • Network bridge: optional xray/Shadowsocks через .env.

Развертывание владельцем

Этот раздел предназначен только для владельца проекта или лиц, получивших прямое письменное разрешение. Наличие инструкций по запуску не предоставляет права использовать, копировать, разворачивать или публиковать проект.

Установить Python dependencies:

pip install -r server/requirements.txt

Создать runtime configuration:

copy .env.example .env

Применить database schema строго по порядку:

mysql -u root AnimeSocial < sql/aviev-schema.sql
mysql -u root AnimeSocial < sql/aviev-schema-pass2.sql

Запустить приложение:

python -B -m server.main

Локальный адрес по умолчанию:

http://127.0.0.1:8787

Health endpoint:

GET /health

Ожидаемый ответ:

{
  "ok": true,
  "sources": ["..."],
  "vpn": true,
  "db": {
    "ok": true,
    "aviev_schema_present": true
  },
  "adblock": {
    "enabled": true,
    "ready": true
  },
  "source_health": {
    "...": {
      "available": true
    }
  }
}

Конфигурация

Backend читает runtime settings из .env, animesocial-db.php и animesocial.json.

Основные группы переменных:

  • AV_BIND_HOST, AV_BIND_PORT — адрес FastAPI.
  • AV_SITE_URL, AV_SITE_NAME — canonical SEO URLs и имя сайта.
  • AV_ALLOWED_ORIGINS — CORS origins для development/production.
  • AV_DB_* — optional DB overrides.
  • AV_USER_* — optional AnimeSocial users-table/column overrides.
  • AV_AUTH_VERIFIER — override password verification strategy.
  • AV_COOKIE_SECURE, AV_COOKIE_SAMESITE, AV_SESSION_TTL_DAYS — session cookie behavior.
  • AV_ANIMESOCIAL_SITE_URL — public host override для AnimeSocial.
  • AV_ADBLOCK_ENABLED, AV_ADBLOCK_FILTER_URLS, AV_ADBLOCK_CACHE_TTL_SECONDS — player Shield filtering behavior.
  • AV_ADBLOCK_REGEX_LIMIT, AV_ADBLOCK_SNIPPET_LIMIT — parser safety limits для runtime filters.
  • AV_PLAYER_PROXY_MAX_TEXT_REWRITE — лимит размера текстовых player-ресурсов для rewriting.
  • SS_ADDRESS, SS_PORT, SS_METHOD, SS_PASSWORD — optional xray outbound.

Production secrets должны храниться только на сервере. Нельзя коммитить реальные пароли, токены, proxy credentials, session data или приватные ключи.

Модель данных

Проект создает и использует только таблицы с префиксом aviev_. Существующие таблицы AnimeSocial остаются источником identity и login credentials.

Основные таблицы проекта:

  • aviev_sessions — HTTP-only login sessions.
  • aviev_user_lists — canonical title status + favorite flag.
  • aviev_watch_history — continue-watching feed.
  • aviev_episode_progress — per-episode progress.
  • aviev_title_ratings — personal ratings.
  • aviev_dub_prefs — preferred dubbing per title.
  • aviev_account_settings — account toggles.
  • aviev_privacy — public profile privacy controls.
  • aviev_activity — contribution/activity graph events.
  • aviev_title_pages — canonical SEO title-page cache.
  • aviev_title_refresh_queue — title page refresh queue.
  • aviev_import_marks — one-time localStorage import markers.

aviev_activity использует unique deduplication index:

UNIQUE KEY uq_act_dedup (user_id, day, kind, mal_id, meta(64))

Безопасность

  • Сессионные токены хранятся на сервере и передаются через HTTP-only cookies.
  • Личные API-методы доступны только при активной авторизованной сессии.
  • Публичные профили отдают данные с учетом настроек приватности пользователя.
  • Плеер принимает iframe postMessage только от ожидаемого окна источника.
  • AsoPlayer использует явные bridge-сообщения для скриншотов, контекстного меню и закрытия меню при кликах внутри sandbox iframe.
  • AsoPlay Shield проксирует player-ресурсы через same-origin слой, фильтрует рекламные URL и блокирует popup/top-navigation сценарии.
  • Прокси ограничены конкретными сценариями для API и media-файлов.
  • robots.txt закрывает внутренние account/auth/proxy/source endpoints.

Авторские права и лицензия

Этот репозиторий не является open source.

Copyright © Чепела Даниэль Максимович (x0doit). Все права защищены.

Никакая лицензия третьим лицам не предоставляется. Без прямого письменного разрешения правообладателя запрещено использовать, копировать, скачивать, зеркалировать, изменять, запускать, разворачивать, хостить, распространять, сублицензировать, перепродавать, публиковать, переупаковывать, использовать для обучения моделей, включать в datasets или создавать производные работы на основе этого репозитория или любой его части.

Полный proprietary notice: COPYRIGHT.

Запросы по лицензированию: https://crazydev.pro/

AsoPlay

Language: Русский | English

AsoPlay is an anime viewing service with a searchable title catalog, SEO-ready title pages, AsoPlayer, personal lists, watch progress, public profiles and AnimeSocial integration. The frontend is written in vanilla JavaScript, the backend runs on Python/FastAPI, and user data is stored in MySQL.

Copyright © Chepela Daniel Maximovich (x0doit). All rights reserved. This repository is not open source. Any use requires direct written permission from the copyright owner.

Contents

Features

  • Catalog and search powered by Jikan, AniList and Shikimori data.
  • Title pages at /anime/{mal_id}-{slug}/ with server-rendered metadata, Open Graph tags, JSON-LD, canonical URLs, sitemap support and <noscript> fallbacks.
  • AsoPlayer with multiple sources, fallback search across supported video providers, quick screenshots, branded context menu and safe iframe postMessage handling.
  • AsoPlay Shield: same-origin player proxy, request-level filtering, runtime AdGuard-backed rules, popup/navigation hardening and careful sandbox iframe handling.
  • AnimeSocial authentication bridge using the existing AnimeSocial MySQL account database with project-local HTTP-only sessions.
  • Personal library with favorites, continue watching, statuses, ratings, dub preferences, settings and privacy controls.
  • Automatic list statuses driven by real watch progress: auto-watching, auto-completed and stale auto-dropped states.
  • Real watch-progress logic driven by player events instead of wall-clock time spent on the page.
  • Public profiles with lists that respect privacy settings and activity graph rendering.
  • Runtime proxy, health state and cache for external APIs, video sources, data and media images.
  • Optional xray/Shadowsocks bridge for environments where upstream anime metadata APIs are blocked.

AsoPlayer and Shield

AsoPlayer is not a standalone library; it is the application-level player layer inside AsoPlay. The page owns source selection, progress, auto-next behavior, context-menu actions and user workflows, while the iframe bridge handles safe communication with the actual embedded player.

Key capabilities:

  • Right-click context menu: Сделать скриншот, Копировать ссылку на аниме, Аниме соц сеть.
  • Quick PNG screenshots of the current frame with clean filenames: AsoPlay-{mal_id}-ep{episode}-{hh}-{mm}-{ss}.png.
  • Dedicated Kodik skin in assets/player/kodik-skin.css with the branded #ff6666 accent.
  • Same-origin player proxy for iframe and media URLs.
  • AsoPlay Shield for filtering ad URLs, blocking popup/navigation flows and reducing noisy third-party behavior inside sandboxed players.
  • Dedicated internal player resources: /player/asoplay-shield.js, /player/kodik-skin.css, /player/frame, /player/proxy, /player/cvh-api/*.

Architecture

.
├── index.html                  SPA shell and SSR placeholders
├── app.js                      public router, catalog, title page, player
├── styles.css                  application design system
├── assets/                     static media assets
│   └── player/
│       └── kodik-skin.css      AsoPlayer/Kodik visual skin
├── js/
│   └── account.js              auth UI, personal sections, store, profiles
├── server/
│   ├── main.py                 FastAPI app wiring, static serving, sources
│   ├── animesocial.py          AnimeSocial DB auth bridge and sessions
│   ├── animesocial_config.py   AnimeSocial URL/media configuration
│   ├── account_api.py          account compatibility API
│   ├── adblock.py              AdGuard-backed request filtering
│   ├── user_lists.py           list/status/favorite domain and auto-rules
│   ├── activity_log.py         contribution/activity event log
│   ├── profile_pages.py        public profile API and SSR shell
│   ├── title_pages.py          canonical anime pages, sitemap, robots
│   ├── proxies.py              Jikan/AniList/Shiki/translate/image proxies
│   ├── player_proxy.py         same-origin player proxy, Shield, iframe bridge
│   ├── source_health.py        source failure/cooldown state
│   ├── vpn_bridge.py           optional xray runtime bridge
│   ├── animevost.py            native AnimeVost source adapter
│   ├── oldyummy.py             native old.yummyani source adapter
│   └── requirements.txt        Python runtime dependencies
├── sql/
│   ├── aviev-schema.sql        base aviev_* schema
│   └── aviev-schema-pass2.sql  lists, privacy, activity and compatibility
├── animesocial.json            AnimeSocial public URL/media mapping
├── animesocial-db.php          AnimeSocial DB config format
├── vpn.template.json           xray config template
├── .env.example                environment template
├── COPYRIGHT                   proprietary copyright notice
└── .gitignore                  ignored local/runtime artifacts

Stack

  • Frontend: plain HTML, CSS and JavaScript ES modules.
  • Backend: Python 3.11+, FastAPI, Uvicorn, httpx.
  • Database: MySQL 8 / OpenServer-compatible AnimeSocial database.
  • Auth: existing AnimeSocial users table + project-local aviev_sessions.
  • Metadata: Jikan, AniList, Shikimori.
  • Player layer: same-origin iframe/media proxy, sandbox bridge, request-level ad filtering.
  • Network bridge: optional xray/Shadowsocks through .env.

Owner Deployment

This section is for the project owner and explicitly licensed operators only. Publishing operational instructions does not grant permission to use, copy, deploy, host or redistribute the project.

Install Python dependencies:

pip install -r server/requirements.txt

Create runtime configuration:

copy .env.example .env

Apply database schema in order:

mysql -u root AnimeSocial < sql/aviev-schema.sql
mysql -u root AnimeSocial < sql/aviev-schema-pass2.sql

Start the application:

python -B -m server.main

Default local URL:

http://127.0.0.1:8787

Health endpoint:

GET /health

Expected response:

{
  "ok": true,
  "sources": ["..."],
  "vpn": true,
  "db": {
    "ok": true,
    "aviev_schema_present": true
  },
  "adblock": {
    "enabled": true,
    "ready": true
  },
  "source_health": {
    "...": {
      "available": true
    }
  }
}

Configuration

The backend reads runtime settings from .env, animesocial-db.php and animesocial.json.

Important environment groups:

  • AV_BIND_HOST, AV_BIND_PORT — FastAPI bind address.
  • AV_SITE_URL, AV_SITE_NAME — canonical SEO URLs and site name.
  • AV_ALLOWED_ORIGINS — CORS origins for development or production.
  • AV_DB_* — optional DB overrides.
  • AV_USER_* — optional AnimeSocial users-table/column overrides.
  • AV_AUTH_VERIFIER — password verification strategy override.
  • AV_COOKIE_SECURE, AV_COOKIE_SAMESITE, AV_SESSION_TTL_DAYS — session cookie behavior.
  • AV_ANIMESOCIAL_SITE_URL — AnimeSocial public host override.
  • AV_ADBLOCK_ENABLED, AV_ADBLOCK_FILTER_URLS, AV_ADBLOCK_CACHE_TTL_SECONDS — player Shield filtering behavior.
  • AV_ADBLOCK_REGEX_LIMIT, AV_ADBLOCK_SNIPPET_LIMIT — parser safety limits for runtime filters.
  • AV_PLAYER_PROXY_MAX_TEXT_REWRITE — maximum textual player resource size for rewriting.
  • SS_ADDRESS, SS_PORT, SS_METHOD, SS_PASSWORD — optional xray outbound.

Production secrets must stay outside Git. Never commit real passwords, tokens, private proxy credentials, session data or private keys.

Data Model

The application creates and owns only tables with the aviev_ prefix. Existing AnimeSocial tables remain the source of identity and login credentials.

Core project tables:

  • aviev_sessions — HTTP-only login sessions.
  • aviev_user_lists — canonical title status + favorite flag.
  • aviev_watch_history — continue-watching feed.
  • aviev_episode_progress — per-episode progress.
  • aviev_title_ratings — personal ratings.
  • aviev_dub_prefs — preferred dubbing per title.
  • aviev_account_settings — account toggles.
  • aviev_privacy — public profile privacy controls.
  • aviev_activity — contribution/activity graph events.
  • aviev_title_pages — canonical SEO title-page cache.
  • aviev_title_refresh_queue — title page refresh queue.
  • aviev_import_marks — one-time localStorage import markers.

aviev_activity uses a unique deduplication index:

UNIQUE KEY uq_act_dedup (user_id, day, kind, mal_id, meta(64))

Security

  • Session tokens are stored on the server and sent through HTTP-only cookies.
  • Private account endpoints require authenticated sessions.
  • Public profile endpoints enforce privacy rules on the server.
  • The player accepts iframe postMessage events only from the expected source window.
  • AsoPlayer uses explicit bridge messages for screenshots, context-menu actions and menu closing when clicks happen inside sandboxed iframes.
  • AsoPlay Shield routes player resources through a same-origin layer, filters ad URLs and blocks popup/top-navigation flows.
  • Proxy endpoints are constrained to specific API/media scenarios.
  • robots.txt blocks internal account/auth/proxy/source endpoints.

Copyright and License

This repository is not open source.

Copyright © Chepela Daniel Maximovich (x0doit). All rights reserved.

No license is granted to any third party. Without direct written permission from the copyright owner, no person or organization may use, copy, download, mirror, modify, run, deploy, host, distribute, sublicense, resell, publish, repackage, train on, index into a dataset, or create derivative works from this repository or any part of it.

Full proprietary notice: COPYRIGHT.

Licensing inquiries: https://crazydev.pro/

About

Сервис для просмотра аниме с каталогом, поиском, личными списками и интеграцией AnimeSocial.

Topics

mysql anime vanilla-js anime-streaming fastapi user-profiles proprietary-software watch-progress anime-catalog animesocial

Resources

Readme
Activity

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases 18

AsoPlay v1.0.11 Latest
May 3, 2026
+ 17 releases

Packages

 
 
 

Contributors

Languages