misaka_danmu_server  by l429609201

Danmaku aggregation and management service for personal media

Created 11 months ago
1,195 stars

Top 32.0% on SourcePulse

GitHubView on GitHub
Project Summary

A powerful self-hosted danmaku aggregation and management service, Misaka Danmu Server provides a unified, private API for personal media libraries by scraping danmaku from mainstream video websites. It targets users seeking to enhance their media consumption experience by synchronizing danmaku with local files, featuring a modern web interface for management and control.

How It Works

This service scrapes danmaku in real-time from third-party platforms and public APIs, linking it to user media via intelligent matching using filenames or metadata (TMDB, TVDB, etc.). A web UI facilitates danmaku searching, import, library management, API token generation for clients (e.g., yamby, SenPlayer), and source configuration. Automation via webhooks integrates with media servers like Sonarr/Radarr. Deployment is simplified using Docker, with optional AI-assisted matching available via external services.

Quick Start & Requirements

Deployment primarily uses Docker images and Docker Compose files, allowing for rapid setup. The project recommends using a mainland China IP address for optimal video source access; overseas users may require proxy configuration due to potential regional restrictions. Official documentation provides detailed setup guides.

Highlighted Details

  • Smart Danmaku Matching: Utilizes filenames or integrated metadata (TMDB, TVDB, etc.) for accurate danmaku association.
  • Web Management UI: Offers a comprehensive interface for searching, importing, managing danmaku libraries, API tokens, data sources, and viewing system logs.
  • Metadata Integration: Supports TMDB, TVDB, Bangumi, Douban, and IMDb for enriched media information.
  • Automation Capabilities: Integrates with Sonarr, Radarr, and Emby via webhooks for automated danmaku fetching.
  • API Compatibility: Ensures seamless integration with clients supporting the dandanplay API specification.
  • AI-Assisted Matching: Leverages external AI services for enhanced matching accuracy.

Maintenance & Community

The project is hosted on GitHub and maintains a community presence via a Telegram channel. Official documentation is available online. The AI-assisted matching feature is sponsored by 云AI, an API aggregation platform.

Licensing & Compatibility

The project's license is indicated by a GitHub shield but is not explicitly stated within the provided README text. It is designed for compatibility with clients supporting the dandanplay API specification and offers API token generation for various third-party media players and management tools.

Limitations & Caveats

Reliance on real-time scraping from third-party websites makes the service vulnerable to changes in source site structures or anti-scraping measures, potentially leading to service interruptions or IP blocking. Network and regional restrictions necessitate using a mainland China IP or configuring proxies for overseas users to access necessary video sources. Users are responsible for adhering to third-party service terms, potential content risks, and legal compliance, as developers disclaim liability for service availability and content-related issues.

Health Check
Last Commit

20 hours ago

Responsiveness

Inactive

Pull Requests (30d)
4
Issues (30d)
3
Star History
43 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.