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 11 months ago
IACR-eprint Initial Commit 11 months ago
amnesty Initial Commit 11 months ago
arxiv-cs.CR Initial Commit 11 months ago
bitcoin-releases Initial Commit 11 months ago
grin-annoucements Initial Commit 11 months ago
i2pblog Initial Commit 11 months ago
journalist-leighcuen Initial Commit 11 months ago
journalist-zackwhittaker Initial Commit 11 months ago
katzenpost-blog Initial Commit 11 months ago
monero Initial Commit 11 months ago
openprivacy-blog README updates 11 months ago
privacy-international Initial Commit 11 months ago
proof-of-work Initial Commit 11 months ago
pt-reyes Initial Commit 11 months ago
reddit-rtlsdr Initial Commit 11 months ago
reveal Initial Commit 11 months ago
seashepherd Initial Commit 11 months ago
securedrop Initial Commit 11 months ago
tor-blog Initial Commit 11 months ago
weather Initial Commit 11 months ago
zcash-blog Initial Commit 11 months ago
zcash-fnd-blog Initial Commit 11 months ago
.gitignore Initial Commit 11 months ago
LICENSE License Upates 11 months ago
README.md Enforce Tor on Feeds 11 months ago
main.go User Agent 11 months ago
report-pic.png README updates 11 months ago
report.template Initial Commit 11 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.