[](https://www.npmjs.com/package/aqualink)
[](https://www.npmjs.com/package/aqualink)
[](https://github.com/ToddyTheNoobDud/AquaLink/stargazers)
[](https://discord.gg/K4CVv84VBC)
🌊 REIMAGINING AUDIO STREAMING FOR DISCORD 🌊
Experience crystal-clear audio with unmatched stability
## 💎 Why Choose Aqualink?
🚀
Performance First
Optimized architecture with 50% less latency than other wrappers
|
🛠️
Developer Friendly
Intuitive API with extensive documentation and CJS/ESM support
|
🔌
Extendable
Plugin ecosystem for custom functionality and seamless integration
|
## 🔥 Feature Highlights
Advanced Filters
EQ, Bass Boost, Nightcore & more
|
Fail-Safe System
Auto-reconnect & queue preservation
|
Real-time Analytics
Performance monitoring & insights
|
Customizable
Adapt to your specific needs
|
## 📦 Resources
## 💻 Quick Start
```javascript
npm install aqualink
// If you're using Module, use this:
// import { createRequire } from 'module';
// const require = createRequire(import.meta.url);
//const { Aqua } = require('aqualink');
const { Aqua } = require("aqualink");
const { Client, Collection, GatewayDispatchEvents } = require("discord.js");
const client = new Client({
intents: [
"Guilds",
"GuildMembers",
"GuildMessages",
"MessageContent",
"GuildVoiceStates"
]
});
const nodes = [
{
host: "127.0.0.1",
password: "yourpass",
port: 233,
secure: false,
name: "localhost"
}
];
const aqua = Aqua(client, nodes, {
defaultSearchPlatform: "ytsearch",
restVersion: "v4",
autoResume: false,
infiniteReconnects: true,
});
client.aqua = aqua;
client.once("ready", () => {
client.aqua.init(client.user.id);
console.log("Ready!");
});
client.on("raw", (d) => {
if (![GatewayDispatchEvents.VoiceStateUpdate, GatewayDispatchEvents.VoiceServerUpdate,].includes(d.t)) return;
client.aqua.updateVoiceState(d);
});
client.on("messageCreate", async (message) => {
if (message.author.bot) return;
if (!message.content.startsWith("!play")) return;
const query = message.content.slice(6);
const player = client.aqua.createConnection({
guildId: message.guild.id,
voiceChannel: message.member.voice.channel.id,
textChannel: message.channel.id,
deaf: true,
});
const resolve = await client.aqua.resolve({ query, requester: message.member });
if (resolve.loadType === 'playlist') {
await message.channel.send(`Added ${resolve.tracks.length} songs from ${resolve.playlistInfo.name} playlist.`);
for (const track of resolve.tracks) {
player.queue.add(track)
}
if (!player.playing && !player.paused) return player.play();
} else if (resolve.loadType === 'search' || resolve.loadType === 'track') {
const track = resolve.tracks.shift();
track.info.requester = message.member;
player.queue.add(track);
await message.channel.send(`Added **${track.info.title}** to the queue.`);
if (!player.playing && !player.paused) return player.play();
} else {
return message.channel.send(`There were no results found for your query.`);
}
});
client.aqua.on("nodeConnect", (node) => {
console.log(`Node connected: ${node.name}`);
});
client.aqua.on("nodeError", (node, error) => {
console.log(`Node "${node.name}" encountered an error: ${error.message}.`);
});
client.login("Yourtokenhere");
```
## 🌟 Featured Projects
[View All Projects →](https://github.com/ToddyTheNoobDud/AquaLink#used-by)
**300+** weekly downloads • **3+** GitHub stars • **3+** Discord bots
## 📖 Documentation
For detailed usage, API references, and examples, check out our official documentation:
[](https://toddythenoobdud.github.io/aqualink.github.io)
📌 **Get Started Quickly**
- Installation guide
- API methods
- Advanced features
- Troubleshooting
🔗 Visit: **[Aqualink Docs](https://toddythenoobdud.github.io/aqualink.github.io)**
## 👑 Premium Bots Using Aqualink
| Bot | Invite Link | Features |
|-----|-------------|----------|
| Rive | [Add to Discord](https://discord.com/oauth2/authorize?client_id=1350601402325405806) | Music playback, Queue management |
| Kenium | [Add to Discord](https://discord.com/oauth2/authorize?client_id=1202232935311495209) | Audio streaming, Discord integration |
## 🛠️ Advanced Features
🎛️ Audio Filters
- Equalizer (15-band)
- Bass Boost & Bass Cut
- Nightcore & Vaporwave
- 8D Audio & Rotation
- Karaoke & Channel Mixing
|
🔄 Queue Management
- Shuffle & Loop modes
- Queue history & navigation
- Auto playlist continuation
- Skip voting systems
- Playlist import/export
|
📊 Monitoring
- Resource utilization
- Performance metrics
- Automatic issue detection
- Node health tracking
- Load balancing
|
## 👥 Contributors
[Become a contributor →](CONTRIBUTING.md)
## 🤝 Contributing
We welcome contributions from developers of all skill levels! Whether it's adding features, fixing bugs, or improving documentation.
[](CONTRIBUTING.md)
## 💬 Community & Support
Join our thriving community of developers and bot creators!
[](https://discord.gg/K4CVv84VBC)
[](https://github.com/ToddyTheNoobDud/AquaLink/discussions)
Built with 💙 by the Aqualink Team
