KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #ai-agents #claude-code #dsh #dsh-plugin #deepseek-harness #cli #macos #ai-agent #open-source

Onyx

★ 67 Open GitHub ↗

A NodeJS Discord bot used by 1000+ servers

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Onyx Discord Bot
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) 
[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.png?v=103)](https://github.com/ellerbrock/open-source-badges/)
![GitHub top language](https://img.shields.io/github/languages/top/badges/shields.svg)
![GitHub last commit](https://img.shields.io/github/last-commit/google/skia.svg)
![Powered by NodeJS](https://img.shields.io/badge/powered%20by-nodejs-blue.svg)

Onyx is a multi-purpose media and utility bot, containing over 50 commands to help you bring the best of the web to your server.

Watch YouTube videos, search for GIFs and stickers, get answers to everything, and more, with Onyx. This bot is powered by Node.JS, and coded using
the Discord.JS library.

Make electronic music, memes, edit images, get answers to everything, and more, with Onyx, a Discord bot powered by Node.JS, and coded using
the Discord.JS library.

Onyx has over fifty commands, including those for:
- meme generation
- gif and sticker searching
- searching YouTube
- music production
- fetching info/live imagery from NASA
- interacting with IBM's Watson API 
- getting information on any topic

## Documentation
[View documentation relating to Onyx's commands and usage here.](https://silvia-odwyer.github.io/Onyx)

## Get Stickers From Giphy!
![Get Stickers With This Command](https://github.com/silvia-odwyer/NodeJS-Discord-Bot/blob/master/media/sticker_examples.gif "Yes, you can search GIPHY for stickers!")

## Make Memes!
![Make Memes With This Command](https://github.com/silvia-odwyer/NodeJS-Discord-Bot/blob/master/media/meme_example.gif "Yes, you can even make memes!")

A complete list of currently working commands can be found below.

## UPDATES: 28/12/2018
- Send cool eCards and GIFts to other users!
- Get stickers from GIPHY. 👀
- YouTube Integration Now Here! Search for your favourite videos, watch, and enjoy!
- Search Pixabay for public domain photos. `-pixabay night sky`
- Get random cute Ascii Faces!
- Get public domain, stunning images from Unsplash with `-photo`
- Captcha generation now possible! `-captcha Only humans can read this.`

## Invite To Your Server
[Just click here to invite Onyx to your server!](https://discordapp.com/oauth2/authorize?&client_id=444948120573313024&scope=bot&permissions=0)

## Test Onyx Out In This Support Server
If you want to test Onyx out before adding her to your server, [just join this server](https://discord.gg/cSWHaEK), and leave when you want.
Onyx runs 24/7, so she'll always be online. :D

## Onyx In Action
### Ask Onyx Anything You Like!
![Ask Onyx Anything You Like!](https://github.com/silvia-odwyer/NodeJS-Discord-Bot/blob/master/ask_example.gif "Ask Onyx Anything You Like!")

![Ask Onyx Anything You Like! (Yes, even questions like this!)](https://github.com/silvia-odwyer/NodeJS-Discord-Bot/blob/master/media/ask2_example.gif "Ask Onyx Anything You Like!  (Yes, even questions like this!)")

### Get Public Domain Photos From Unsplash
![Get Public Domain Photos From Unsplash](https://github.com/silvia-odwyer/NodeJS-Discord-Bot/blob/master/media/unsplash_example.gif "Get Public Domain Photos From Unsplash")

### Generate QR Codes
![Generate QR Codes](https://github.com/silvia-odwyer/NodeJS-Discord-Bot/blob/master/media/qr_example.gif "Generate QR Codes")

## Commands
NB: Prepend a hyphen before any of the commands below.

### Make Electronic Music
You can make your own electronic music just by typing commands, and connecting to a Voice Channel.
Onyx comes with a series of built-in, royalty-free samples, which you can play through a Voice Channel.

Right now, you can play samples, and overlay/combine samples together.

### Music Production Commands

| Command       | Description   | Examples  |
| ------------- |:----------------------------------------------------------------------------------------------:| ---------: |
| music_cmds         | Get a list of all samples available to play. (Make sure you've joined a voice channel first.)      |   `-music_cmds`  |
| futurebass           | Futurebass sample. To play this sample, just type the command.                 |   `-futurebass`   |
| fx    | The `fx` command overlays two samples over one another. In the example to the right, fx combines the two samples `futurebass` and `build` together, overlaying their audio upon one another.                       |  `-fx futurebass build`    |

### Media Commands
| Command       | Description   | Examples  |
| ------------- |:----------------------------------------------------------------------------------------------:| --------- |
| meme          | Make a meme, using a variety of templates. Separate the meme's top and bottom text using a hyphen.  | `-meme waitingskeleton This is top text-This is bottom text`    |
| meme_templates      | Get a list of all meme templates available.|  `-meme_templates`   |
| yt      | Search YouTube for your favourite videos. Returns the first search result video.|  `-yt Swedish House Mafia greyhound`   |
| xkcd          | (Nerd Humour) Get today's XKCD comic, or a randomized XKCD comic.                            |  `-xkcd` or `-xkcd today`    |
| photo          | Search Unsplash for public domain, stunning images of your choice.                      |  `-unsplash night sky`    |
| pixabay    |   Search Pixabay for public domain images.     |   `-pixabay night sky`   |

### Space/Astronomy/NASA Commands

| Command       | Description   | Examples  |
| ------------- |:----------------------------------------------------------------------------------------------:| ---------: |
| earth         | See live footage of Earth, as seen from the NOAA DSCVRY probe.                                   |   `-earth`  |
| neo           | Find out how many Near-Earth objects are near Earth right now.                              |    `-neo`  |
| astronauts    | Find out how many astronauts are aboard the International Space Station.                         |    `-astronauts`  |
| iss           | Get the location of the International Space Station. Updates every second.                    |    `-iss`  |

![Get Live Earth Footage](https://github.com/silvia-odwyer/NodeJS-Discord-Bot/blob/master/media/earth_example.gif "Get live footage of Earth from NASA!")

### Search Commands
| Command       | Description   | Examples  |
| ------------- |:----------------------------------------------------------------------------------------------:| --------- |
| search        | Get all the synonyms for a word.                                                                 |  `-search azure `   |
| bitcoin       | Retrieve today's bitcoin rates.                                                                  |    `-bitcoin`  |
| acronym       | Get the meaning of an acronym. --> acronym lol                                                   | `-acronym rofl` |
| oldDefine        | Get an old-style definition of a word like it's 1859.                                            |  `-oldDefine dancing`  |
| define        | Get a definition of a word.                                        |  `-define dancing`  |
| translate     | Translate text to a variety of languages, including French (fr), Italian (it), German (de), and more! | `-translate fr How are you?`|
| identify      | Identify what language a piece of text is in, plus the result includes Watson AI's confidence levels too! |`-identify Hello there, how are you?` |
| emoji         | Search for emojis related to a certain search term. Get happy emojis, cute emojis, hearts, etc.| `-emoji hearts `  |
| population    | Get the total number of humans on Earth right now.                                               |   `-population`   |
| rhyme    |  Get words that rhyme with a word of your choice.                                  |   `-rhyme red`   |
| name    |  Find out how popular your first name is, plus get stats on it.                                  |   `-name Markus`   |
| ask    |   Ask Onyx anything, and she'll provide an answer from Wolfram Alpha, an information engine.     |   `-ask is there life on Mars`   |

![Get Emoji](https://github.com/silvia-odwyer/NodeJS-Discord-Bot/blob/master/media/getemoji_example.gif "Get emoji related to your search term!")

### Fun Commands
| Command       | Description   | Examples  |
| ------------- |:----------------------------------------------------------------------------------------------:| --------- |
| qr            | Generate a QR code in black & white. Create a multi-coloured QR code with the `qr+` command.              |  `-qr This is a qr-encoded message`|
| qr+            | Generate a qr code with two HEX colours and your message encoded as a QR code.                   |  `-qr+ fff 000 This is a qr-encoded message`|
|pls react      | Get a tonload of reactions for no reason. 👀 🤣 😃 😄 😅 😆 😉                                |  `-pls react`   |
| emojify       | Convert your message into an emojipasta. Adds emojis related to words found within the message. | `-emojify I loooove emojis`     |
|cs_jokes     | Get a coding/computer science-related joke.                         |  `-cs_jokes`   |
|captcha     | Turn plaintext into a captcha.                        |  `-captcha Hello there`   |
|cats     | Get a load of cuuuute cat ascii faces                        |  `-cats`   |
|asciiFaces     | Get a load of cuuuute ascii faces ^^                     |  `-asciiFaces`   |
|poll     | Create a poll. Just append a question onto your command, and the reactions will symbolise votes.                   |  `-poll Do you want more text channels?`   |

![Ask Onyx for Acronym Meanings](https://github.com/silvia-odwyer/NodeJS-Discord-Bot/blob/master/media/acronym_example2.gif "Ask Onyx for Acronym Meanings")

### Message Formatting Commands
| Command       | Description   | Examples  |
| ------------- |:----------------------------------------------------------------------------------------------:| --------- |
| randomCase    |Randomize every letter in a sentence's case, so iT tUrnS oUt lIke ThIS.| `-randomCase this is a sample sentence`   |
| letterEm      | Convert all the letters in a message to emoji letters. |`-letterEm These letters look like emojis.`  |
| replaceB      | Replace all the b's in a message with the 🅱️ emoji. | `-replaceB Bye bye letter B's!`  |
| pyramid       | Convert a sentence into a word pyramid. Try it out! |   `-pyramid This text looks like a pyramid.`   |
| reverse       | Reverse your message. | `-reverse Hello There`|
| binary       | Translate a message to binary. | `-binary Hello There`|
| 1337       | Translate a message to 1337. | `-1337 Hello There`|
| adv1337       | Translate a message to advanced 1337. | `-adv1337 Hello There`|

### Social Commands
| Command       | Description   | Examples  |
| ------------- |:----------------------------------------------------------------------------------------------:| ---------: |
| avatar        | See your, or someone else's avatar.        |  `-avatar @Silvia923` or `-avatar`    |
| wave          | Wave at another user! |   `-wave @Silvia923`   |
| poke          | Poke another user! | `-poke @somebody`     |
| gift          | Send a gift to another user! | `-gift @Silvia923`|
| card          | Send a card to another user, with your message attached| `-card @Silvia923 Happy Birthday!`|

### Meta Commands
| Command       | Description   | Examples  |
| ------------- |:----------------------------------------------------------------------------------------------:| --------- |
| server            | Get server stats, such as member count, when the server was created, and more...  |  `-server`|
| idea           |Submit an idea for a new bot feature.               |  `-idea New image filters please! Would love to see some sepia filters :eyes:`|
|creator      | Get info. on who coded Onyx :eyes:          |  `-creator`   |
|info      | Get info. about Onyx, such as what language she's coded in, and more.    |  `-info`   |
|invite      | Get Onyx's invite link, so that she can be invited to other servers.   |  `-invite`   |

## Features On The Way
I am applying for API keys for the following APIs, so that's why their development is slightly delayed.
- Checking if two users should go out together, using IBM Watson's analysis of the two users' messages, and thus deducing their personalities.
- Movie DB search and retrieval for movies and their ratings, actors, etc.,
- Spotify: Provides meta data on various songs.
- Google Knowledge Graph integration
- Basic moderation commands, including kicking users, detecting spam, etc.,

## Invite To Your Server (In case you didn't see above ^^)
[Just click here to invite Onyx to your server!](https://discordapp.com/oauth2/authorize?&client_id=444948120573313024&scope=bot&permissions=0)

## Run The Bot 
To run Onyx on your own server:

1. Clone this repo. 
2. Install dependencies with `npm install`.
3. Create a .env file at the root of the directory, and fill in the API keys and Discord IDs for the following:

```
TOKEN=
WOLFRAM_ALPHA_API_ID=
GIPHY_API_KEY=
IMGFLIP_PASS=
PIXABAY_API_KEY=
UNSPLASH_API_KEY=
YOUTUBE_API_KEY=
OWNER_DISCORD_ID=
LOGGING_CHANNEL_ID=
```

The LOGGING_CHANNEL_ID is the channel where you want your logs to go to. When the bot leaves or is added to a server, for example,
a message notifying you of this will be sent to the logging channel with the specified ID.

4. `npm start`

Make sure to **never** commit your `.env` file to version control, as your token and API keys will get leaked and your bot 
could become compromised.

If the bot is setup successfully and the token is correct, you'll start to see logging appear in the console. ^^

## Test Onyx Out In This Support Server
If you want to test Onyx out before adding her to your server, [just join this server](https://discord.gg/cSWHaEK), and leave when you want.
Onyx runs 24/7, so she'll always be online. :D

Onyx

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README