X-Git-Url: https://vcs.fsf.org/?p=video-tweet.git;a=blobdiff_plain;f=README.md;h=1e3c03545ea05817e912d226cdde3802a014ccf8;hp=643537a6f2bf66d84831ab3c8317fbd64fccd06c;hb=HEAD;hpb=03695c6586ee10fb96035a58c07de58b42bc52f4 diff --git a/README.md b/README.md index 643537a..1e3c035 100644 --- a/README.md +++ b/README.md @@ -1,26 +1,30 @@ -# Large Video Upload +Original repo: https://github.com/twitterdev/large-video-upload-python +Changes here are meant to be rebased. -This Python sample demonstrates the following process of uploading large video files asynchronously with the Twitter API. +# Large Media Upload + +This Python sample demonstrates the following process of uploading large media (video / GIF / image) files asynchronously with the Twitter API, via the "chunked upload" method. 1. **INIT** media upload. 2. **APPEND** chunked data. 3. **FINALIZE** media uploaded. -4. Check **STATUS** of video processing. -5. Tweet with attached video. +4. Check **STATUS** of media processing. +5. Tweet with attached media. -Large video files are longer than 30 seconds up to 140 seconds, and/or a file size larger than 15 megabytes up to 512 megabytes. +Large video files are longer than 30 seconds / up to 140 seconds, and/or a file size larger than 15 megabytes up to 512 megabytes. -[Learn more](https://dev.twitter.com/rest/media) about the Twitter Media APIs. Pay attention to the other requirements such as encoding, frame size and video formats supported. +[Learn more](https://developer.twitter.com/en/docs/media/upload-media/overview) about the Twitter Media APIs. Pay attention to the other requirements such as encoding, frame size and video formats supported, as these may be reasons for uploads failing at the processing stage. ## Running the sample 1. Install requirements: ``` - $ pip install -r requirements.txt + $ pipenv shell + $ pipenv install ``` -2. Fill in your [consumer keys and access tokens](https://apps.twitter.com) in `async-upload.py`: +2. Fill in your [consumer keys and access tokens](https://developer.twitter.com/en/apps) in `async-upload.py`: ``` CONSUMER_KEY = 'your-consumer-key' @@ -29,7 +33,7 @@ Large video files are longer than 30 seconds up to 140 seconds, and/or a file si ACCESS_TOKEN_SECRET = 'your-access-secret' ``` -3. Edit path to your video file in `async-upload.py`: +3. Edit path to your media file in `async-upload.py`: ``` VIDEO_FILENAME = 'path/to/video/file'