lavalink-list

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 7 Open GitHub ↗

List of Free Public Lavalink, Feel free to open pull request, support badge generation!

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![lavalink-list](https://socialify.git.ci/AjieDev/lavalink-list/image?description=1&font=Inter&forks=1&language=1&logo=https%3A%2F%2Fcdn-cf.ajieblogs.eu.org%2Fimg%2F1727676032086.png&name=1&owner=1&pattern=Plus&pulls=1&stargazers=1&theme=Auto)

<p align="center">
    <a href="https://free.lavalink.rf.gd/list">The Website</a>
    .
    <a href="https://github.com/AjieDev/lavalink-list/pulls">Make a pull request</a>
  </p>

[EN](README.md) | [ID](docs/README_id-ID.md)

**Attention:** For any extra support, questions, check out our [Discord](https://dsc.gg/ajidevserver).

# Add new nodes
1. Fork this repository
2. Edit the nodes.json file and add your node like the example
3. Create pull request

### nodes.json example
```json
[
    {
        "unique-id": "nodes-v4",
        "identifier": "My Node v4", 
        "host": "lavalink1.example.com",
        "port": 2333, 
        "password": "youshallnotpass",
        "secure": false,
        "version": "v4"
    }
]

```
- `unique-id` - The unique id of your node (example: nodes-v4) (Note: must used lowercase and change space with - )
- `identifier` - The identifier of your node (example: My Node v4)
- `host` - The host of your node (can be sub domain or IP)
- `port` - The port of your node
- `password` - The password of your node (if you have one)
- `secure` - If your node is using SSL (true or false)
- `version` - The version of your node (lavalink rest api version) (v3 or v4)

# API

### Badges

Stats service also supports badges generation, here the breakdown:

```
https://lavalink-list-api.ajieblogs.eu.org/<unique-id>/badge/<type>
```
- `<unique-id>` - Your unique-id
- `<type>` - Badge type, supported badge type are: `Players`, `Status`, `Load`

Example: `https://lavalink-list-api.ajieblogs.eu.org/ajiedev-lavalinkv4/badge/Players` <br />
Output: ![Players](https://lavalink-list-api.ajieblogs.eu.org/ajiedev-lavalinkv4/badge/Players) <br />

Example: `https://lavalink-list-api.ajieblogs.eu.org/ajiedev-lavalinkv4/badge/Status` <br />
Output: ![Players](https://lavalink-list-api.ajieblogs.eu.org/ajiedev-lavalinkv4/badge/Status) <br />

Example: `https://lavalink-list-api.ajieblogs.eu.org/ajiedev-lavalinkv4/badge/Load` <br />
Output: ![Players](https://lavalink-list-api.ajieblogs.eu.org/ajiedev-lavalinkv4/badge/Load)

### Raw json list

Deployed config are in here https://lavalink-list-api.pages.dev/nodes.json

# Note

- Stats service may spam your stats and info endpoint (based on how many people opens the website and badges being generated), if you have firewall or rate limit you can whitelist this IP:

```
2a06:98c0:3600::103
```

- Node will marked as offline if timeout for 3 seconds
- Inactive servers or nodes may get deleted to avoid status delay.

# FAQ

- Q: The Status API is open source?
- A: No (It was actually planned but someone copied it and we cancelled it.)
----------------------
- Q: Can i get my lavalink stats api.
- A: Currently working on it. (Probably "No" but we will find another way and additional issues above)
----------------------
- Q: Can we remove inactive nodes?
- A: If you think helps, why not?

# Contributors

lavalink-list

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README