aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 376815cc1a925a9edec54e1148cfe30bb7151b0e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# video2story

**video2story** is a Python tool that allows you to convert and upload videos to your Telegram stories. It automatically cuts the video into segments and uploads them to your Telegram account.

## Installation

To install `video2story`, use pip:

```bash
pip install video2story
```

## Usage

### 1. Process the video

```bash
video2story video input.mp4 output_dir/
```

First, split the video into segments. Replace `input.mp4` with the path to your video file and `output_dir/` with the directory where you want to save the processed segments:

By default, the video will be cut into 60-second segments. To change that, use the `-d` option and specify the duration in seconds:

### 2. Upload the processed video

```bash
video2story PHONE_NUMBER output_dir/ -p friends
```

Replace `PHONE_NUMBER` with your Telegram phone number and `output_dir/` with the directory containing the processed video segments.

The `-p` option allows you to choose the privacy level for your story. For more options and detailed information, use the `--help` flag.

## License

This project is licensed under the GPL (GNU General Public License). See the [LICENSE](/LICENSE) file for more details.