Let’s untangle it.
A few quick checks for the things that can get in the way.
Quick fixes
Alice stops at configuration
Fill in API_ID, API_HASH, BOT_TOKEN, STRING_SESSION and MONGO_URL in Config.env. Check that numeric fields contain numbers and that the filename uses the correct capital letters.
FFmpeg or FFprobe is missing
Install FFmpeg on the bot host. On Ubuntu: sudo apt install ffmpeg. On macOS: brew install ffmpeg. Restart Alice after installation.
The assistant cannot join or play
Open the group voice chat. Confirm assistant membership and permission to speak. The bot also needs permission to invite the assistant and manage voice chats.
A search result has expired
Run /search again. Results last five minutes, and only the person who requested the search can choose one.
No song matches my request
Include both the song title and artist, or use /search to choose a result. Supported direct song links use jiosaavn.com/song/.
Playback controls say admin only
Pause, skip, stop and queue edits are for group admins or the configured bot owner. Check your group role or OWNER_ID.
The queue is full or a track is too large
Use a track within MAX_DOWNLOAD_MB and MAX_TRACK_MINUTES, or remove an upcoming item. MAX_QUEUE_SIZE controls the queue cap including the current song.
The owner menu is missing
Message /help privately to the bot from the account matching OWNER_ID. Owner tools are private-chat only.
The startup notice is missing
Check LOG_GROUP_ID and the bot’s membership and send permissions in that chat. A value of 0 disables the notice.
Statistics are not saving
Check MONGO_URL, database authentication and permission for the bot host to connect to MongoDB.
Check the music catalog
Run the catalog diagnostic from the project folder. It makes internet requests and downloads sample audio, without connecting the bot to Telegram.
.venv/bin/python scripts/check_music.pyInspect the last 100 lines from your running tmux session:
tmux capture-pane -p -S -100 -t aliceAsk the community
Share the command you tried, what you expected and the error message in our Telegram support group ↗. Remove tokens, session strings and database credentials before sharing logs.
KEEP GOINGBack to the commands