Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sangupta/digg-reader-dump

Command-line tool to take dump of your Digg Reader account
https://github.com/sangupta/digg-reader-dump

Last synced: 4 days ago
JSON representation

Command-line tool to take dump of your Digg Reader account

Awesome Lists containing this project

README

        

# digg-reader-dump

Command-line tool to take dump of your Digg Reader account.

# Why?

Digg Reader does not allow me to take a dump of all my data, except the OPML file. My saved
articles, my diggs etc - neither it provides me a way to search in them. Thus I wrote this
tool in my spare time to dump all of them for me, and probably allow me to search in them
in future. Thus, I wrote this command-line tool in 2015 to do the same for me.

**Digg Reader is being shut down on March 26, 2018**. Save all your data.

Download 1.0.0 release: https://github.com/sangupta/digg-reader-dump/releases/tag/1.0.0

# Hacking

Use Oracle JDK and Apache Maven to build the project:

```
$ mvn clean package
```

# Usage

The following commands are available:

```
usage: $ java -jar digg-reader-dump.jar []

The most commonly used digg commands are:
all Dump all articles
diggs Dump digged articles
help Display help information
popular Dump popular articles
saved Dump saved articles
subs Dump user subscriptions

See 'digg help ' for more information on a specific command.
```

Examples:

```
# To dump all saved articles
$ java -jar digg-reader-dump-1.0.0.jar saved -c

# To export an OPML of all subscriptions
# java -jar digg-reader-dump-1.0.0.jar subs -c
```
You will need to extract the **cookie value** from your Digg Reader account using the Network
requests tab of your favorite browser. Just copy and paste the entire cookie (response header)
value as the last argument enclosed in single-quotes. Refer to following browser specific help
articles to see how to capture cookie value:

* Chrome: https://developers.google.com/web/tools/chrome-devtools/network-performance/reference
* Firefox: https://developer.mozilla.org/en-US/docs/Tools/Network_Monitor
* Safari: https://developer.apple.com/safari/tools/
* Edge: https://docs.microsoft.com/en-us/microsoft-edge/devtools-guide/network
* Internet Explorer: https://msdn.microsoft.com/en-us/library/gg130952(v=vs.85).aspx
* Opera: https://www.opera.com/dragonfly/documentation/network/
* Samsung Internet Explorer: http://developer.samsung.com/tv/develop/getting-started/using-sdk/web-inspector

The tool creates the following 4 folders depending on the command that you
selected as:

* diggs
* popular
* saved
* all

A sample output from my own dump from Mar 20, 2018 is:

```
Saved article (98795e1a264c86e5bbbc1b416c3a664c44fba283.json): Introducing Google Browser Size
Saved article (bbcd24f683c1bb10ad6492296f4bfbc3a75d3a58.json): Spring 3.0.0 is Now Available
Saved article (44956eb7c9f7d7cc180fc41887583e71d5fbdf80.json): WordPress Creates a Twitter Compatible API
Saved article (dddac5a0dc7017d5cd0c22b2b87d172cd6bb14b6.json): Search Engine Optimization (SEO) Toolkit
Saved article (a87c5c827b64e3aa34d0c7f15a57ad67ca3939b0.json): Tech Thursday - cloud things, map things and ship things

There are no more feed items in your subscriptions to export!
```

# License

```
digg-reader-dump - CLI to export data out of Digg Reader
Copyright (c) 2015-2018, Sandeep Gupta

http://sangupta.com/projects/digg-reader-dump

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```