| Name | tsdtool JSON |
| Version |
1.0.0
JSON |
| download |
| home_page | None |
| Summary | Script that downloads telegram stories. |
| upload_time | 2025-10-28 06:04:32 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | None |
| keywords |
library
telegram
stories
download
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# tsdtool
> _From the creators of [rcdtool](https://github.com/David256/rcdtool)..._
Script that downloads telegram stories.
## Usage
For help:
```bash
./tsdtool --help
```
This script needs the story link to download it.
```bash
tsdtool -c /path/to/config.ini --link "https://t.me/<username>/s/<id>" -O /tmp/path/to/directory
```
Then the script starts the downloading.
### Download all the current stories
You can pass the channel and download all the public stories:
```bash
tsdtool -c /path/to/config.ini -C "<username or channel ID>" -O /tmp/path/to/directory
```
### Download the pinned stories
These stories are saved as "posts":
```bash
tsdtool --pinned-stories -C "<username or channel ID>" -O /tmp/path/to/directory
```
### Download an specific story
You can pass the channel and the story ids separated by comma:
```bash
tsdtool -C "<username or channel ID>" --story-ids 23
```
or...
```bash
tsdtool -C "<username or channel ID>" --story-ids 23,24,40
```
## Dist
In this repository we release the source code (Python) and a binary option for GNU/Linux. You can build a binary for any other operating system using tool as [PyInstaller](https://pyinstaller.org/en/).
## Telegram session
You MUST have an API ID provided by Telegram at https://my.telegram.org/ (I think). This is as follows:
```
api_id: 32767
api_hash: ed855a59bbe4a3360dbf7a0538842142
```
Then rename `config.ini.sample` to `config.ini`, edit it and save wherever you want. If the file is in the same directory as `tsdtool` and its name is exactly "config.ini", then `tsdtool` will load it automatically.
The first time, **tsdtool** will ask you for your phone number, and will start a login process. When this is done, a `.session` file will be created. With this `.session` file, the tool could access to your Telegram account to read messages and download medias. The name of the .session file is set in `config.ini`.
Raw data
{
"_id": null,
"home_page": null,
"name": "tsdtool",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "library, telegram, stories, download",
"author": null,
"author_email": "David Waster <wasterdavid@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/e9/bc/c5ea26c9a8d8af3352a756427aff12f794afeaad2fb5c1db6cd5f600a0d6/tsdtool-1.0.0.tar.gz",
"platform": null,
"description": "# tsdtool\n\n> _From the creators of [rcdtool](https://github.com/David256/rcdtool)..._\n\nScript that downloads telegram stories.\n\n## Usage\n\nFor help:\n\n```bash\n./tsdtool --help\n```\n\nThis script needs the story link to download it.\n\n```bash\ntsdtool -c /path/to/config.ini --link \"https://t.me/<username>/s/<id>\" -O /tmp/path/to/directory\n```\n\nThen the script starts the downloading.\n\n### Download all the current stories\n\nYou can pass the channel and download all the public stories:\n\n```bash\ntsdtool -c /path/to/config.ini -C \"<username or channel ID>\" -O /tmp/path/to/directory\n```\n\n### Download the pinned stories\n\nThese stories are saved as \"posts\":\n\n```bash\ntsdtool --pinned-stories -C \"<username or channel ID>\" -O /tmp/path/to/directory\n```\n\n### Download an specific story\n\nYou can pass the channel and the story ids separated by comma:\n\n```bash\ntsdtool -C \"<username or channel ID>\" --story-ids 23\n```\n\nor...\n\n```bash\ntsdtool -C \"<username or channel ID>\" --story-ids 23,24,40\n```\n\n## Dist\n\nIn this repository we release the source code (Python) and a binary option for GNU/Linux. You can build a binary for any other operating system using tool as [PyInstaller](https://pyinstaller.org/en/).\n\n## Telegram session\n\nYou MUST have an API ID provided by Telegram at https://my.telegram.org/ (I think). This is as follows:\n\n```\napi_id: 32767\napi_hash: ed855a59bbe4a3360dbf7a0538842142\n```\n\nThen rename `config.ini.sample` to `config.ini`, edit it and save wherever you want. If the file is in the same directory as `tsdtool` and its name is exactly \"config.ini\", then `tsdtool` will load it automatically.\n\nThe first time, **tsdtool** will ask you for your phone number, and will start a login process. When this is done, a `.session` file will be created. With this `.session` file, the tool could access to your Telegram account to read messages and download medias. The name of the .session file is set in `config.ini`.\n",
"bugtrack_url": null,
"license": null,
"summary": "Script that downloads telegram stories.",
"version": "1.0.0",
"project_urls": null,
"split_keywords": [
"library",
" telegram",
" stories",
" download"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "affbc5e742e30c2ff460f4aa1eb48c5e3cf8ae1964e58c68b7fee2245d21f695",
"md5": "9e4ec05a8fd1b85d7ecadbd05480f902",
"sha256": "1921a201c80b56d9c54e4f995e426f7b15e8d8e6eb3a5e61e4fb40e40363c06f"
},
"downloads": -1,
"filename": "tsdtool-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9e4ec05a8fd1b85d7ecadbd05480f902",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 9341,
"upload_time": "2025-10-28T06:04:31",
"upload_time_iso_8601": "2025-10-28T06:04:31.248593Z",
"url": "https://files.pythonhosted.org/packages/af/fb/c5e742e30c2ff460f4aa1eb48c5e3cf8ae1964e58c68b7fee2245d21f695/tsdtool-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e9bcc5ea26c9a8d8af3352a756427aff12f794afeaad2fb5c1db6cd5f600a0d6",
"md5": "dde540bf6a1b61f8834fa6be36f94984",
"sha256": "e977670e01713b7cd7e4790d09946a29f01be607ad23c428c30b3ceb1dd8ba4e"
},
"downloads": -1,
"filename": "tsdtool-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "dde540bf6a1b61f8834fa6be36f94984",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 7707,
"upload_time": "2025-10-28T06:04:32",
"upload_time_iso_8601": "2025-10-28T06:04:32.212269Z",
"url": "https://files.pythonhosted.org/packages/e9/bc/c5ea26c9a8d8af3352a756427aff12f794afeaad2fb5c1db6cd5f600a0d6/tsdtool-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-28 06:04:32",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "tsdtool"
}
