AniX/player-parsers/README.md
2025-05-31 12:46:20 +05:00

3.4 KiB

AniX - Player Parsers

This sub-project allows obtaining direct video file links from sources Sibnet, Kodik, Anilibria (source: libria)

It can be used both for the main AniX project and as a standalone service.

In the main project, the parsers are used to operate the internal player. If this function is not important to you, you may choose not to deploy this sub-service.

License: MIT

Usage

In the web browser address bar, enter:

<http|https>://<ip|domain><:port>/?url=<VIDEO_URL>&player=<PLAYER_SOURCE>

where:

  • http|https - the scheme used to connect to the service
  • ip|domain - IP address or domain where the service is hosted
  • :port - service port, optional
  • VIDEO_URL - the link to the video from the source
  • PLAYER_SOURCE - the source, one of: kodik, sibnet, libria

Note

When using libria source, url should be the url to the anilibria api, not player directly

Response:

  • 500|400: an error occurred, see the message field in the response body for details
  • 200: request was successful

Deployment

Important

Due to the nature of the sources, it is recommended to use a virtual server in Russia, as they may be inaccessible from other countries.

Because of this specificity, the parsers cannot be deployed on edge services like Cloudflare Workers or Deno, only on a dedicated server.

Docker

Requirements:

Pre-built

  1. Run the command:

docker run -d --name anix-player -p 7000:7000 radiquum/anix-player-parser:latest

Manual build

Additional Requirements:

  1. Clone the repository git clone https://github.com/Radiquum/AniX
  2. Navigate to the repository directory cd AniX
  3. Navigate to the parsers directory cd player-parsers
  4. Run the command docker build -t anix-player-parser .
  5. Once finished, run the command: docker run -d --restart always --name anix-player -p 7000:7000 anix-player-parser

docker/Legend

  • -d - run container in the background
  • --restart always - always restart after server reboot
  • --name - container name
  • -p - container port accessible externally. PORT:7000

docker/After deployment

The service will be available at: http://<YOUR IP><:YOUR PORT>/

docker/Note

To use your own domain and support the HTTPS protocol, you can use Traefik or another reverse-proxy with an SSL certificate.

Useful links:

pm2

Requirements:

Instructions:

  1. Clone the repository git clone https://github.com/Radiquum/AniX
  2. Navigate to the repository directory cd AniX
  3. Navigate to the parsers directory cd player-parsers
  4. Run the command npm install
  5. Once finished, run the command pm2 start index.ts -n anix-player-parser

pm2/Legend

  • -n - service name in pm2

pm2/After deployment

The service will be available at: http://<YOUR IP>:7000/

pm2/Note

To enable automatic application start, it is recommended to configure pm2 to start on boot with the command: pm2 startup

Useful links: