Gathers up feeds and images from around the web (over tor), and displays them in custom reports.

Sarah Jamie Lewis f2ef624070 User Agent 3 weeks ago
IACR-eprint 03d784d7c4 Initial Commit 3 weeks ago
amnesty 03d784d7c4 Initial Commit 3 weeks ago
arxiv-cs.CR 03d784d7c4 Initial Commit 3 weeks ago
bitcoin-releases 03d784d7c4 Initial Commit 3 weeks ago
grin-annoucements 03d784d7c4 Initial Commit 3 weeks ago
i2pblog 03d784d7c4 Initial Commit 3 weeks ago
journalist-leighcuen 03d784d7c4 Initial Commit 3 weeks ago
journalist-zackwhittaker 03d784d7c4 Initial Commit 3 weeks ago
katzenpost-blog 03d784d7c4 Initial Commit 3 weeks ago
monero 03d784d7c4 Initial Commit 3 weeks ago
openprivacy-blog 8c3f68f4f6 README updates 3 weeks ago
privacy-international 03d784d7c4 Initial Commit 3 weeks ago
proof-of-work 03d784d7c4 Initial Commit 3 weeks ago
pt-reyes 03d784d7c4 Initial Commit 3 weeks ago
reddit-rtlsdr 03d784d7c4 Initial Commit 3 weeks ago
reveal 03d784d7c4 Initial Commit 3 weeks ago
seashepherd 03d784d7c4 Initial Commit 3 weeks ago
securedrop 03d784d7c4 Initial Commit 3 weeks ago
tor-blog 03d784d7c4 Initial Commit 3 weeks ago
weather 03d784d7c4 Initial Commit 3 weeks ago
zcash-blog 03d784d7c4 Initial Commit 3 weeks ago
zcash-fnd-blog 03d784d7c4 Initial Commit 3 weeks ago
.gitignore 03d784d7c4 Initial Commit 3 weeks ago
LICENSE dd4e7363e8 License Upates 3 weeks ago
README.md 230cdac046 Enforce Tor on Feeds 3 weeks ago
main.go f2ef624070 User Agent 3 weeks ago
report-pic.png 8c3f68f4f6 README updates 3 weeks ago
report.template 03d784d7c4 Initial Commit 3 weeks ago

README.md

Raccoon - A tool for privately generating reports from data feeds

You either build your own information processing pipelines or you become subject to someone else's.

I wanted a tool that would provide the following features:

  • Fetch data from the Internet at defined periods over Tor
  • Allow me to display that data in a configurable way.
  • Would let me extend the functionality over time.

After investigating a few options I could find nothing that fit quite right.

Usage

Create a new folder to hold all of your feeds e.g.

    mkdir feeds
    cd feeds

Create some feeds, each feed is a subfolder that contains a file feedinfo e.g.

    mkdir openprivacy-blog
    echo "https://openprivacy.ca/feed.xml 1440" > openprivacy-blog/feedinfo 

For now feedinfo just contains a single line with the URL of the feed and how often to check for updates (in minutes, in this case 1440 is once per day)

You can now run raccoon update to fetch all of your feeds over Tor. It will only attempt to fetch feeds that haven't been checked for the given update period.

To produce reports, you can run raccoon report <report.template> and raccoon will produce a markdown/html hybrid of a report that can be piped to a utility like markdown to produce a html report.

The report.template file can be customized as needed, some basic guidelines to the format:

  • Lines beginning with % are ignored
  • Line beginning with < or # are printed as-is (for injecting HTML or markdown specifically)
  • Report lines have the following (rought) format:

    <folder-name> ALL|DAY|WEEK|[0-9]* (Title|Link|Description)*
    
  • Each report line can either print out a list of ALL items in the feed, or all items from the last DAY or the last WEEK, or a specific feed item (counting from 0)

  • For each feed item you can print out the Title, Link & Description or any combination.

Please see the report.template provided in this repository for a more complete example.

You can also download images (or technically any other file) using a file called images in the directory (see the pt-reyes folder) - this is useful if you want to download specific data (like satellite images) from a resource that updates fairly often.

Notes

You will need to be running a local tor proxy on port 9050

There is very little in the way of graceful error handling, contributions appreciated, please also feel free to submit issues & feature requests.