ilo wawa

ilo wawa li ilo pana sona pi toki pona li sitelen e sitelen pona.

This Discord bot was created to be a learning tool for the Toki Pona language. The bot's name, ilo wawa, means "strong tool". ilo wawa can give information about toki pona words and etymologies, search for dictionary definitions, and convert written toki pona to a sitelen pona image.

Getting Started

Prerequisites

ilo wawa was built for Node.js and thus node and npm are used to install the prerequisite packages and run the bot.

Optionally, the GIMP is needed if you wish to use the sitelen conversion command.

You will also need to visit the Discord developer portal to set up a bot account and get a token.

Installing the Bot

• Download ilo wawa's source code and use npm i in the install directory. (Optional, sitelen only: Install the GIMP)
• Visit the Discord dev portal to set up an app and a bot account, and copy the client token into config.json. Also take note your app's client ID for the next step.
• (Optional, for sitelen) Move the linja-pona-4.0.otf font from etc to your machine's font directory.
• (Optional, for sitelen) Find the GIMP's directory on your machine and copy it into the appropriate field in config.json. If running Windows be sure to escape backslashes. Move ilo wawa's sitelen.scm script to the GIMP's scripts directory (usually located in share).
• Run the bot by using node index in a terminal in the install directory.
• Invite the bot to your Discord server by changing CLIENT_ID_HERE to your client ID in this link: https://discordapp.com/oauth2/authorize?client_id=CLIENT_ID_HERE&scope=bot&permissions=0

Donate

If you've learned something from ilo wawa in a server... or if you have ever benefitted from this bot's code... please consider donating to help keep ilo wawa alive! ❤

Authors

• jan Tesa (Jezza Hehn) - Anthrakia (personal website)
• jan Kai - development assistance and troubleshooting
• jan Akuton - compiled dictionary and helped with language support
• jan Jeko - pu/nonpu booleans in dictionary

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

• Special thanks goes to jan Sonja, original creator of the Toki Pona language.
• Thanks also to all the members of ma pona pi toki pona for continuing to support this project!