Sources on tgs

tgs sources list

Mon, 01 Jan 0001 00:00:00 +0000

tgs sources list#

Enumerate all Telegram dialogs in your account — channels, supergroups, groups, users, and bots.

Usage#

tgs sources list [flags]

Flags#

Flag	Short	Type	Default	Description
`--type`		string[]	(all)	Filter by type: `channel`, `supergroup`, `group`, `user`, `bot` (repeatable, comma-separated)
`--with-stats`		bool	`false`	Fetch expensive metrics (total/24h/first messages + full info) for every returned source
`--limit`	`-l`	int	`0`	Max records to return (1-500, 0=all)
`--cursor`		string		Pagination cursor from previous response
`--folder`		string	`""`	Filter to chats inside this folder (id or name), archived chats included; incompatible with `--cursor`
`--archived`		bool	`false`	Include archived dialogs (ignored when `--folder` is set — a folder already includes its archived chats)
`--max-wait`		int	`60`	Max seconds to wait on FLOOD_WAIT
`--no-cache`		bool	`false`	Disable peer and stats caches
`--profile`	`-p`	string		Account profile name

Profile resolution order when --profile is not set: TGS_PROFILE env -> .tgs.yaml file -> "default".

tgs sources inspect

Mon, 01 Jan 0001 00:00:00 +0000

tgs sources inspect#

Fetch detailed information for a single Telegram source. Works for sources you are subscribed to as well as public channels you are not a member of.

Usage#

tgs sources inspect <ref> [flags]

The ref argument identifies the target source. Supported formats:

Format	Example	Description
`@username`	`@durov`	Public username with `@` prefix
`username`	`durov`	Public username without prefix
`id:<n>`	`id:-1001234567890`	Telegram peer ID (recommended for negative IDs — pflag eats bare `-N` as a flag)
Numeric ID	`12345`	Positive peer ID. For negative IDs use the `id:` form above, or insert `--` (e.g. `inspect -- -1001234567890`)
Phone number	`+79001234567`	For contacts and your own account
`-` or `@me`	`-`	Saved Messages (your personal chat)

Flags#

Flag	Short	Type	Default	Description
`--no-stats`		bool	`false`	Skip expensive stats (total/24h/first messages)
`--no-cache`		bool	`false`	Disable peer and stats caches
`--max-wait`		int	`60`	Max seconds to wait on FLOOD_WAIT
`--profile`	`-p`	string		Account profile name

Profile resolution order when --profile is not set: TGS_PROFILE env -> .tgs.yaml file -> "default".

tgs sources folders

Mon, 01 Jan 0001 00:00:00 +0000

tgs sources folders#

Enumerates the user’s Telegram folders (dialog filters from the UI) and resolves each one’s contents the way the Telegram client does — applying pinned/include/exclude peers and auto-flags (contacts, groups, etc.) to the full dialog list.

The default “All chats” folder is excluded; only user-defined folders and shared chatlists appear in the output.

Usage#

tgs sources folders [flags]

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 resolution order when --profile is not set: TGS_PROFILE env -> .tgs.yaml file -> "default".