Gathers up feeds and images from around the web (over tor), and displays them in custom reports.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Sarah Jamie Lewis f2ef624070 User Agent 5 months ago
IACR-eprint Initial Commit 5 months ago
amnesty Initial Commit 5 months ago
arxiv-cs.CR Initial Commit 5 months ago
bitcoin-releases Initial Commit 5 months ago
grin-annoucements Initial Commit 5 months ago
i2pblog Initial Commit 5 months ago
journalist-leighcuen Initial Commit 5 months ago
journalist-zackwhittaker Initial Commit 5 months ago
katzenpost-blog Initial Commit 5 months ago
monero Initial Commit 5 months ago
openprivacy-blog README updates 5 months ago
privacy-international Initial Commit 5 months ago
proof-of-work Initial Commit 5 months ago
pt-reyes Initial Commit 5 months ago
reddit-rtlsdr Initial Commit 5 months ago
reveal Initial Commit 5 months ago
seashepherd Initial Commit 5 months ago
securedrop Initial Commit 5 months ago
tor-blog Initial Commit 5 months ago
weather Initial Commit 5 months ago
zcash-blog Initial Commit 5 months ago
zcash-fnd-blog Initial Commit 5 months ago
.gitignore Initial Commit 5 months ago
LICENSE License Upates 5 months ago
README.md Enforce Tor on Feeds 5 months ago
main.go User Agent 5 months ago
report-pic.png README updates 5 months ago
report.template Initial Commit 5 months 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.