Usage #
This page introduces some of Save Any Bot’s features and basic usage. If you can’t find what you need here, please also see the Configuration Guide or ask in GitHub Discussions.
File Transfer #
To use the bot’s Telegram file saving feature, you need to send or forward the following types of messages to the bot:
- File or media messages, such as images, videos, documents, etc.
- Telegram message links, for example:
https://t.me/acherkrau/1097. Even if the channel prohibits forwarding and saving, the bot can still download its files. - Telegra.ph article links. The bot will download all images in the article.
Silent Mode (silent) #
Use the /silent command to toggle silent mode.
By default, silent mode is off, and the bot will ask you for the save location of each file.
When silent mode is enabled, the bot will save files directly to the default location without confirmation.
Before enabling silent mode, you need to set the default save location using the /storage command.
Storage Rules #
Storage rules allow you to define redirection rules when the bot uploads files to storage, so that saved files are automatically organized.
See: #28
Currently supported rule types:
- FILENAME-REGEX
- MESSAGE-REGEX
- IS-ALBUM
Basic syntax for adding rules:
“RuleType RuleContent StorageName Path”
Pay attention to spaces; the bot can only parse correctly formatted syntax. Below is an example of a valid rule command:
/rule add FILENAME-REGEX (?i)\.(mp4|mkv|ts|avi|flv)$ MyAlist /videos
In addition, if CHOSEN is used as the storage name in the rule, it means files will be stored under the path of the storage you selected by clicking the inline button.
Rule types:
FILENAME-REGEX #
Matches based on filename regex. The rule content must be a valid regular expression, such as:
FILENAME-REGEX (?i)\.(mp4|mkv|ts|avi|flv)$ MyAlist /videos
This means files with extensions mp4, mkv, ts, avi, flv will be saved to the /videos directory in the storage named MyAlist (also affected by the base_path in the configuration file).
MESSAGE-REGEX #
Similar to the above, but matches based on the text content of the message itself.
IS-ALBUM #
Matches album messages (media groups). Rule content can only be true or false.
If the path in the rule uses NEW-FOR-ALBUM, the bot will create a new folder for each media group and store all files of that group there. See: https://github.com/krau/SaveAny-Bot/issues/87
For example:
IS-ALBUM true MyWebdav NEW-FOR-ALBUM
This will save media-group messages to the storage named MyWebdav, creating a new folder (generated from the first file) for each album.
Watch Chats #
This feature requires enabling UserBot integration.
You can watch messages in a specific chat and automatically save them to the default storage, following storage rules. You can also add filters so that only matching messages are saved.
Watch a chat:
/watch <chat_id/username> [filter]
Stop watching:
/unwatch <chat_id/username>
Filter types:
msgre #
Regex-match the message text. For example:
/watch 12345678 msgre:.*hello.*
This will watch the chat with ID 12345678, and only save messages whose text contains hello.
Save Files Outside Telegram #
Besides files on Telegram, the bot can also save files from other websites via JavaScript plugins or built-in parsers.
See the Contributing Parsers document for details.
Just send links that match the requirements of a parser to the bot. Currently built-in parsers include:
- Kemono