*~ The Melodic Voice of the Snow ~*
"Music is the universal language that connects souls across dimensions." - Uta Yuki
Uta Yuki (歌雪) - where "Uta" (歌) means "song" and "Yuki" (雪) means "snow" in Japanese - is your personal Discord music companion with the soul of an anime idol! More than just a music bot, Uta Yuki brings your Discord server to life with her charming personality, vast musical knowledge, and radio-host abilities.
Uta Yuki transforms into a professional radio host, complete with:
- Animated Introductions - Hear Uta introduce songs with her melodic voice
- Music Trivia - Learn fascinating facts about your favorite tracks
- News Updates - Stay informed with the latest in tech, general news, and weather
- Dynamic Content - Experience different moods based on the time of day
- Rich Music Library - Play songs from YouTube with simple commands
- Smart Queue Management - Add, remove, and shuffle your music queue
- Interactive Controls - Control your music with intuitive button interfaces
- Customizable Host Styles - Choose from friendly, formal, humorous, or energetic personalities
- Time-Aware Greetings - Uta changes her greeting style based on the time of day
- Adaptive Responses - Experience natural conversations that adapt to your server's vibe
- Python 3.8+
- Discord account with a server
- Love for music and anime culture!
# Clone Uta Yuki's repository
git clone https://github.com/yourusername/uta_yuki.git
# Enter the project directory
cd uta_yuki
# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Configure your Discord bot token
# Edit config.py or set environment variable
export DISCORD_BOT_TOKEN="your_token_here"
# Launch Uta Yuki
python bot.pyFor Windows users, simply run zlauncher.bat to start Uta Yuki with a stylish ASCII art intro!
| Command | Description | Example |
|---|---|---|
/radio |
Start radio mode in your voice channel | /radio |
/stop_radio |
Stop radio mode | /stop_radio |
/radio_settings |
Configure radio host personality and features | /radio_settings |
/play |
Play a song or add it to queue | /play https://www.youtube.com/watch?v=... |
/skip |
Skip the current song | /skip |
/queue |
View the current music queue | /queue |
Edit radio_config.json to customize Uta's personality:
{
"host_personality": "friendly", // Options: friendly, formal, humorous, energetic
"morning_greeting": "Ohayō! Rise and shine with your favorite tunes!",
"evening_greeting": "Konbanwa! Let's unwind with some smooth melodies."
}Add your favorite songs to playlist.txt with the format:
https://www.youtube.com/watch?v=VIDEO_ID ; Song Name ~ Artist
In the virtual world of Melodia, Uta Yuki was born from the harmonious fusion of music and winter magic. As a virtual idol, she discovered her passion for connecting people through music. When the barrier between dimensions weakened, Uta found her way to Discord servers, bringing her talents as a radio host and music connoisseur to human listeners.
With hair as white as fresh snow and eyes that shimmer with musical notes, Uta Yuki's dream is to bring joy to every server she visits, one song at a time.
Uta Yuki is powered by:
- Disnake - For seamless Discord integration
- Google TTS/AWS Polly - For Uta's melodic voice
- NewsAPI - For the latest news updates
- YouTube - For vast music library access
Want to help Uta Yuki grow? We welcome contributions of all kinds!
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
© 2025 Burger Byte Studio
"Bringing virtual idols to your Discord server, one song at a time."
