search

brunolalb / yawk

Yet Another Weather app for Kobo
34 stars 5 forks source link

readme

yawk: Yet Another Weather app for Kobo

Based on Kevin Short's app

Running on Python's distribution from NiLuJe

Using the excellent library FBInk from NiLuJe

Uses Open Weather Maps as forecast and current conditions provider

Everything was tested on a Kobo Glo (N613) using the firmware 4.15.12920 (python3.9.1 on kobo-stuff-1.6.N-r18009)

Everything was tested on a Kobo Touch (kobo3/N905) using the firmware 4.20.14622 (python2.7 on kobo-stuff-1.5.N-r16911)

Disclaimer

The procedure I'm suggesting here will most likely void the warranty.

Follow the guidelines at your own risk, I'm not responsible for any problems that might arise from this app's usage.

Installation

  1. I suggest you Reset your device to factory defaults:
    1. Turn it off
    2. Holding the Light Switch, slide the power button for ~1 sec
    3. Hold the Light switch until the "Restoring" screen appears
    4. Follow directions on the screen (you'll need the Kobo Setup app and an account, I used from RakutenKobo itself)
    5. Update everything, connect to your WiFi network
  2. Provide telnet access - you can skip this step if you're able to find out the IP address of the device using some other method.
    1. Check the file .kobo/ip.txt for the IP address
  3. Install NiLuJe's Stuff - tested with Version 1.6.N @ r18009 on 2021-Jan-22
    1. Download the pre built stuff
    2. Extract contents to a folder
    3. Connect the Kobo using the USB cable and copy the KoboRoot.tgz to the /.kobo/ folder
    4. Remove the device and let it do its thing (it should reboot)
  4. Using the preferred FTP client (ie: WinSCP), copy the repository's content to the folder /mnt/onboard/.apps/yawk
  5. Create an account in Open Weather Maps:
    1. Take note of your API key
    2. Find out the ID your city (use the website to check the weather in your city, copy the ID from the URL)
  6. Open a SSH (or telnet) connection (user: root, password blank):
    1. Install Python 3 tmux new -s kobo update-kobostuff Python
    2. Navigate to /mnt/onboard/.apps/yawk/ and run install.sh
      1. if it says "-sh ./install.sh: not found", you have to convert the line endings to unix style: sed -i 's/^M$//' install.sh
      2. Answer the questions correctly

Screenshot

Screenshot

Doubts, suggestions

brunolalb@gmail.com