Giter VIP home page Giter VIP logo

goosepaper's Introduction

a daily newsfeed delivered to your remarkable tablet

PyPI

Docker Cloud Automated build GitHub Workflow Status Codecov

what's up

goosepaper is a utility that delivers a daily newspaper to your remarkable tablet. that's cute!

you can include RSS feeds, Twitter feeds, news articles, wikipedia articles-of-the-day, weather, and more. I read it when I wake up so that I can feel anxious without having to get my phone.

survey

[New!] In response to feedback, I'm collecting anonymous survey responses. Do you want a goosepaper delivered but without requiring any code? Please let me know your thoughts!

get started with docker

By far the easiest way to get started with Goosepaper is to use Docker.

step 0: write your config file

Write a config file to tell Goosepaper what news you want to read. An example is provided in example-config.json.

step 1: generate your paper

From the directory that has the config file in it, run the following:

docker run -it --rm -v $(pwd):/goosepaper/mount j6k4m8/goosepaper goosepaper -c mount/example-config.json -o mount/Goosepaper.pdf

(where example-config.json is the name of the config file to use).

step 2: you are done!

If you want to both generate the PDF as well as upload it to your reMarkable tablet, you can pass the --upload flag to the docker command above. You must additionally mount your ~/.rmapy file:

docker run -it --rm \
    -v $(pwd):/goosepaper/mount \
    -v $HOME/.rmapy:/root/.rmapy \
    j6k4m8/goosepaper \
    goosepaper -c mount/example-config.json -o mount/Goosepaper.pdf --upload

Otherwise, you can now email this PDF to your tablet, perhaps using ReMailable.

get started without docker: installation

dependencies:

this tool uses weasyprint to generate PDFs. You can install all of the python libraries you need with pip3 install -r ./requirements.txt from this repo, but you may need these prerequisites before getting started.

more details here.

mac:

brew install cairo pango gdk-pixbuf libffi

ubuntu-flavored:

sudo apt-get install build-essential python3-dev python3-pip python3-setuptools python3-wheel python3-cffi libcairo2 libpango-1.0-0 libpangocairo-1.0-0 libgdk-pixbuf2.0-0 libffi-dev shared-mime-info

windows:

Follow these instructions carefully.

and then:

From inside the goosepaper repo,

pip3 install -e .

get started

You can customize your goosepaper by editing config.json. (More instructions, and customization tools, all coming soon!)

goosepaper --config myconfig.json --output mypaper.pdf

If you don't pass an output flag, one will be generated based upon the time of generation. You DO need to pass a config file for now.

An example config file is included here: example-config.json.


Check out this example PDF, generated on Nov 1 2020.

existing story providers (want to write your own?)

More Questions, Infrequently Asked

yes but pardon me โ€” i haven't a remarkable tablet

Do you have another kind of tablet? You may generate a print-ready PDF which you can use on another kind of robot as well! Just remove the last line of main.py.

very nice! may i have it in comic sans?

yes! you may do anything that you find to be fun and welcoming :)

Check out the styles.Styles enum in the goosepaper library. You will find there what you seek.

do all dogs' names start with the letter "B"?

I do not think so, but it is a good question!

may i use this to browse twitter?

yes you may! you can add a list of usernames to the feed generator and it will make a print-ready version of twitter. this is helpful for when you are on twitter on your laptop but wish you had Other Twitter as well, in print form.

You May Also Like...

  • remailable: Email PDF documents to your reMarkable tablet
  • rmapy fork: My fork of rmapy, with added features and bugfixes

goosepaper's People

Contributors

j6k4m8 avatar kwillno avatar sterlingbaldwin avatar kevingoh avatar sergioaboard avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.