Kushiro is a simple yet delightful tool designed to fetch and display random anime from your "Plan to Watch" list on MyAnimeList (MAL). If you're unsure what to watch next, let Kushiro surprise you with a random pick!
- 🎲 Fetches random anime from your "Plan to Watch" list.
- 💻 User-friendly web interface.
- 🚀 Quick setup and seamless integration with MyAnimeList.
Before starting, ensure you have the following installed on your system:
- Node.js
Download and install it from the Node.js Official Website.
Follow these steps to set up Kushiro on your local machine:
git clone https://github.com/desujoy/kushiro
cd kushiro- Retrieve your MyAnimeList Client ID by creating an application on MyAnimeList API Configuration.
- Copy the Client ID and paste it into the
sample.envfile. - Rename
sample.envto.env:mv sample.env .env
npm installnode index.jsOpen the application in your browser at:
http://localhost:3000/
We ❤️ contributions! Here’s how you can contribute:
- Fork the repository.
- Create a new branch:
git checkout -b feature-name
- Make your changes and commit them:
git commit -m "Add your descriptive message here" - Push your branch:
git push origin feature-name
- Create a pull request on GitHub.
This project is licensed under the MIT License.
If you encounter any issues or have questions, feel free to open an issue on the GitHub repository.
- Ensure your MyAnimeList account has the "Plan to Watch" list populated for the app to function properly.
- Feel free to customize the UI and add new features to enhance your experience.
Let Kushiro guide your next anime journey! 🌟