tgs sources folders#

Перечисляет папки Telegram пользователя (диалоговые фильтры из интерфейса) и раскрывает содержимое каждой из них так, как это делает клиент Telegram — применяя закреплённые / включённые / исключённые пиры и автоматические правила (контакты, группы и т.д.) к полному списку диалогов.

Папка «Все чаты» по умолчанию исключается из вывода; отображаются только пользовательские папки и чат-листы.

Использование#

tgs sources folders [flags]

Флаги#

Flag	Short	Type	Default	Description
`--max-wait`		int	`60`	Max seconds to wait on FLOOD_WAIT
`--no-cache`		bool	`false`	Disable peer cache
`--profile`	`-p`	string		Account profile name

Порядок определения профиля, если --profile не указан: переменная TGS_PROFILE -> файл .tgs.yaml -> "default".

Примеры#

# List all user-defined folders and their contents
tgs sources folders

# Disable peer cache (force fresh data)
tgs sources folders --no-cache

# Use a specific profile
tgs sources folders --profile secondary

Вывод#

{
  "folders": [
    {
      "id": 2,
      "kind": "custom",
      "title": "Crypto",
      "emoticon": "💰",
      "chats_count": 12,
      "chats": [
        {
          "id": -1001234567890,
          "type": "channel",
          "title": "BTC News",
          "username": "btcnews",
          "unread_count": 3,
          "pinned": true,
          "last_message": {"id": 9876, "date": "2026-05-27T10:00:00Z"}
        }
      ]
    },
    {
      "id": 5,
      "kind": "chatlist",
      "title": "Go Community",
      "chats_count": 8,
      "chats": []
    }
  ],
  "total": 2
}

Поля папки#

Поле	Тип	Описание
`id`	int	ID диалогового фильтра в Telegram
`kind`	string	`custom` — пользовательская папка; `chatlist` — чат-лист
`title`	string	Отображаемое название папки
`emoticon`	string	Эмодзи папки; отсутствует, если не задано
`has_my_invites`	bool	В чат-листе есть ссылки-приглашения, созданные вами; присутствует только если `true`
`chats_count`	int	Количество чатов в массиве `chats`
`chats`	array	Разрешённые записи чатов (та же структура, что и источники в `sources list`)
`total`	int	Общее количество возвращённых папок

Записи чатов внутри chats имеют ту же структуру полей, что и источники в tgs sources list.

Примечания#

Содержимое папки всегда включает архивные чаты. Папка в Telegram — это сквозное представление, которое может охватывать архив, поэтому команда обходит и основной список диалогов, и архив, и раскрывает каждого участника — ровно так, как вы видите папку в официальном клиенте. Флага --archived здесь нет: он был бы избыточен.
Содержимое папок не разбивается на страницы. Общее число папок невелико (Telegram ограничивает ~30), и чаты каждой папки возвращаются в одном ответе.