Metadata-Version: 2.1
Name: tweets2pdf
Version: 0.0.1
Summary: Parse a Twitter achive JSON and produce a PDF file.
Project-URL: Homepage, https://github.com/qedjoe/tweet-parser
Project-URL: Bug Tracker, https://github.com/qedjoe/tweet-parser/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

# Tweet archive parser

This is a simple tool to parse Twitter archived JSON files and convert to PDF document file format.    

# Acknowledgements

* [Isaac Koi](https://twitter.com/isaackoi/)
* Forked from [vrruiz/tweet-js](https://github.com/vrruiz/tweet-js)
* [qedjoe](https://twitter.com/qedjoe/)
* [DejaVu Fonts](https://dejavu-fonts.github.io/)

# Installation

```bash
pip install tweets2pdf
```

To upgrade to the latest version:

```bash
pip install tweets2pdf --upgrade
```

# Usage

## Download your Twitter archive

See: Twitter Help Centre [How to download your Twitter archive](https://help.twitter.com/en/managing-your-account/how-to-download-your-twitter-archive). Once you have downloaded your archive, look for the `tweets.js` JSON file which contains all your tweets. This code will process that file.

## Run the script

The basic usage is:

```bash
python -m tweets2pdf -f tweets.js -u twitter_username -p output.pdf --images
```

The `--images` option enables the downloading of pictures from Twitter, which will make the process *much slower*.

For more details:
```bash
python -m tweets2pdf --help
```

