User manual

How to use MetaMusic

This is a Telegram bot, not a website you upload to. Open @MetaMusicProBot, then send it a FLAC in a chat. It listens to a fingerprint of that file, looks up the recording, writes a short set of tags, and can drop a copy into your own Google Drive. The audio bits stay as they were — nothing is converted to MP3.

Search-by-name is off right now. Send a file. Song-name lookup will come back when the operator turns it on.

Start

1. Be in a chat the bot already knows

   The bot lives in a group or channel. Join that chat. Direct messages only work after you are a member there (unless the operator made an exception for you). If a private chat says membership is required, join the group first, then message the bot.

2. Say hello with /start

   Send /start in a private chat with @MetaMusicProBot. You should see when you first showed up, how many songs you have edited, whether Drive is connected, and that idle sessions are forgotten after three months. Do this once so later private confirmations have somewhere to land.

3. Send a FLAC — that is the whole job

   Drop a .flac file in the group or in a private chat with the bot. MP3 and other formats are ignored. Photos and Files should be allowed in the group, and the bot should stay an admin, or reactions and cover pictures will not work well.

Optional: connect Google Drive

You do not need Drive to tag a file in Telegram. You need it if you want a copy in folders the bot creates in your account (a library folder and a review folder).

1. Run /login

   The bot sends a private button. Open it. Google asks you to allow a narrow Drive permission: files this app creates, plus the music you sent it — not your whole Drive. Confirm. The window should say Drive is connected. You can close it.

2. Never paste that link in the group

   The login link is one-time and only for you. If it expires, run /login again. If Google says the login died (common while the app is in testing), run /login again too.

3. Pick a default save with /settings

   Choose whether new saves go to library, review, or none (Telegram only). You can unlink Drive there as well. The screen often opens as a Mini App inside Telegram; if that fails, the bot falls back to a normal message.

What happens when you send a FLAC

Think of it as a careful librarian, not a converter.

The bot takes a short acoustic fingerprint — a compact sketch of the sound, not a second copy of the album — and asks public catalogs (AcoustID, then MusicBrainz, and Last.fm when that is configured). It writes only a tight list of Vorbis comments: title, album, artists, composer, genre, date, track and disc numbers, synced lyrics when it finds them, and one front cover. Everything else on the file is stripped. Artists are written as A, B, C & D. Genre is a pipe of genre | mood | language | instrument.

If more than one language shows up, they stay on the genre tag and you pick which library folder to use. If the group allows photos, you may see a few cover choices — tap the one that is right. If no pictures appear, the bot probably lacks photo permission in that chat.

When it is done, the chat gets the tagged audio and a caption. That message is the one you react to.

Reactions on the tagged audio

These are for the public audio+caption the bot posted. Your confirmations stay private (a quiet message only you see, or a DM).

👍 Save to your library

The bot asks first. No copy yet? It copies the current Telegram file into your library (Drive, if connected). Already in review? It offers to move that Drive copy to the library. Already in the library? Nothing happens. The group message stays.

👎 Save to review

Same confirm: copy Telegram → review, or move your library copy into review, or skip if it is already there.

💩 or 🙉 Remove from yours

Deletes the copy from your library or review only. The group message is not removed. Other people keep whatever they already saved. Either emoji does the same job.

🙏 Identify again

Fingerprints and looks up again, then replaces the group or channel audio if the tags change. Individual Drive libraries are left alone until someone 👍 or 👎.

✍️ Edit tags

Opens the tag editor. Commit replaces the group or channel audio for everyone. Drive copies stay as they are. Later 👍 copies that new Telegram file; 👎 copies it into review. The caption remembers who edited. Treat that as a group decision, not a private tweak.

The group needs those reactions enabled: 👍 👎 💩 🙉 🙏 ✍️.

Editing, review, and suggestions

The editor lets you fix title, artists, album, and the rest of the allowlist, and pick a cover. Commit only when the group should all see the new file. That commit does not rewrite anyone’s Drive copy.

/review opens your review folder. From the Mini App (or the private fallback) you can promote a track to the library, keep it as a draft, or cancel. This is your pile, not the group’s.

/suggest looks at what you already have and, with Last.fm, proposes nearby artists and tracks. It is a “what next” list, not a download button. Search-by-name for files you do not have is off at the moment — send a FLAC instead of hoping /get will fetch one.

Commands at a glance

/start

Status: Drive, idle timer, what you can do.

/login

Connect Google Drive. Private, one-time link.

/settings

Default save location (library / review / none) and unlink Drive.

/review

Your review pile.

/suggest

Recommendations from your library.

/get and typing a song name

Temporarily off. The bot will tell you to send a FLAC.

Login, settings, review, and suggest prefer the Mini App inside Telegram (music.avje.in). If the Mini App cannot open, you get the same actions as ordinary private messages.

If you get stuck

Login link expired or Google denied access: /login again. Do not reuse an old URL.

Private chat blocked: join the known group, then /start the bot in DM.

No cover pictures: give the bot permission to send photos in that group.

Someone else’s 🙏 or ✍️ showed up in your Drive after a thumbs-up: that is expected. Identify-again and edit tags replace the group file only. Drive changes when you confirm 👍 or 👎. Only thumbs-up files you still want.

Want Drive gone: unlink in /settings. Music we still have on our servers is deleted after one week. Idle bot sessions are forgotten after three months. Copies already in your Drive stay until you delete them in Drive. Details are on the privacy page.