https://github.com/dessalines/reddit-history

A reddit account history exporter
https://github.com/dessalines/reddit-history

reddit reddit-api reddit-history

Last synced: about 2 months ago
JSON representation

A reddit account history exporter

• Host: GitHub
• URL: https://github.com/dessalines/reddit-history
• Owner: dessalines
• License: gpl-3.0
• Created: 2016-09-01T16:12:31.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2023-12-05T21:38:11.000Z (about 1 year ago)
• Last Synced: 2024-10-13T19:40:02.404Z (2 months ago)
• Topics: reddit, reddit-api, reddit-history
• Language: Java
• Size: 30.3 KB
• Stars: 41
• Watchers: 4
• Forks: 5
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Reddit-History — A reddit account history exporter

========================================================

![](http://img.shields.io/version/0.0.3.png?color=green)

Reddit-History is a reddit history account exporter. It exports your comments, saved threads, submitted posts, and account overview to an organized markdown file, of the format:

```md

subreddit: [worldnews](https://reddit.com/r/worldnews)

[Post/Comment/Saved title](https://reddit.com/r/worldnews/... the reddit link)

Score: 8423

The body of my post, comment, or saved item.

--------------------------------------------

subreddit: [AskReddit](https://reddit.com/r/AskReddit)

....

```

## Installation

### Requirements

- Java 8

### Setup a reddit script client

*This is required to make API calls to reddit at the rate of at least 1 per second.*

- Go [here](https://www.reddit.com/prefs/apps)

- Click create another app

- Click personal use script

- Copy down the `client_id`, and `client_secret` for later use.

### Download

[Download reddit-history.jar](https://github.com/tchoulihan/reddit-history/releases/download/0.0.4/reddit-history.jar)

### Run 

```sh

java -jar reddit-history.jar \

  -user USER_NAME_TO_EXPORT \

  -username YOUR_USERNAME \

  -password YOUR_PASSWORD \

  -client_id CLIENT_ID \

  -client_secret CLIENT_SECRET \

  -sort top

```

`sort` can be `top`, or `new`. 

## Limitations

Unfortunately, reddit *doesn't allow a full account export*, and only lets you retrieve a limit of 1000 records per type(submitted, comments, saved, overview). You can run reddit history using `-sort new` and `-sort top`, to get different slices of your history that reddit will allow.

## Bugs and feature requests

Have a bug or a feature request? If your issue isn't [already listed](https://github.com/tchoulihan/reddit-history/issues/), then open a [new issue here](https://github.com/tchoulihan/reddit-history/issues/new).