ushie / revanced-api

🚀 ReVanced's JSON API

                       

Continuing the legacy of Vanced

🚀 ReVanced API

API server for ReVanced.

❓ About

ReVanced API is a server that is used as the backend for ReVanced. ReVanced API acts as the data source for ReVanced Website and powers ReVanced Manager with updates and ReVanced Patches.

💪 Features

Some of the features ReVanced API include:

• 📢 Announcements: Post and get announcements grouped by channels
• ℹ️ About: Get more information such as a description, ways to donate to, and links of the hoster of ReVanced API
• 🧩 Patches: Get the latest updates of ReVanced Patches, directly from ReVanced API
• 👥 Contributors: List all contributors involved in the project
• 🔄 Backwards compatibility: Proxy an old API for migration purposes and backwards compatibility

🚀 How to get started

ReVanced API can be deployed as a Docker container or used standalone.

🐳 Docker

To deploy ReVanced API as a Docker container, you can use Docker Compose or Docker CLI.
The Docker image is published on GitHub Container registry, so before you can pull the image, you need to authenticate to the Container registry.

🗄️ Docker Compose

1. Create an .env file using .env.example as a template
2. Create a configuration.toml file using configuration.example.toml as a template
3. Create a docker-compose.yml file using docker-compose.example.yml as a template
4. Run docker-compose up -d to start the server

💻 Docker CLI

1. Create an .env file using .env.example as a template
2. Create a configuration.toml file using configuration.example.toml as a template
3. Start the container using the following command:

   docker run -d --name revanced-api \
    # Mount the .env file
    -v $(pwd)/.env:/app/.env \
    # Mount the configuration.toml file
    -v $(pwd)/configuration.toml:/app/configuration.toml \
    # Mount the persistence folder
    -v $(pwd)/persistence:/app/persistence \
    # Expose the port 8888
    -p 8888:8888 \
    # Use the start command to start the server
    -e COMMAND=start \
    # Pull the image from the GitHub Container registry
    ghcr.io/revanced/revanced-api:latest

🖥️ Standalone

To deploy ReVanced API standalone, you can either use the pre-built executable or build it from source.

📦 Pre-built executable

A Java Runtime Environment (JRE) must be installed.

1. Download ReVanced API to a folder
2. In the same folder, create an .env file using .env.example as a template
3. In the same folder, create a configuration.toml file using configuration.example.toml as a template
4. Run java -jar revanced-api.jar start to start the server

🛠️ From source

A Java Development Kit (JDK) and Git must be installed.

1. Run git clone [email protected]:ReVanced/revanced-api.git to clone the repository
2. Copy .env.example to .env and fill in the required values
3. Copy configuration.example.toml to configuration.toml and fill in the required values
4. Run gradlew run --args=start to start the server

📚 Everything else

📙 Contributing

Thank you for considering contributing to ReVanced API. You can find the contribution guidelines here.

🛠️ Building

To build ReVanced API, a Java Development Kit (JDK) and Git must be installed.
Follow the steps below to build ReVanced API:

1. Run git clone [email protected]:ReVanced/revanced-api.git to clone the repository
2. Run gradlew build to build the project

📜 Licence

ReVanced API is licensed under the AGPLv3 licence. Please see the licence file for more information. tl;dr you may copy, distribute and modify ReVanced API as long as you track changes/dates in source files. Any modifications to ReVanced API must also be made available under the GPL along with build & install instructions.