https://github.com/martinpham/kindle-calendar

Transform your Kindle into a Calendar
https://github.com/martinpham/kindle-calendar

Last synced: about 1 month ago
JSON representation

Transform your Kindle into a Calendar

• Host: GitHub
• URL: https://github.com/martinpham/kindle-calendar
• Owner: MartinPham
• License: gpl-3.0
• Created: 2022-12-11T10:10:34.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2022-12-11T21:10:35.000Z (about 2 years ago)
• Last Synced: 2023-03-07T14:05:52.701Z (almost 2 years ago)
• Language: Shell
• Size: 319 KB
• Stars: 24
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  


    



      

        Kindle Calendar

      

    

  

  


    

      Transform your Kindle into a Calendar

    

  

  


  

  


  


![Kindle Calendar](./docs/img.jpg)

  



  Table of contents

---

- [Homepage](#homepage)

- [Features](#features)

- [Usage](#usage)

	- [Installation](#installation)

	- [Configuration](#configuration)

- [Contributing](#contributing)

- [Changelog](#changelog)

- [License](#license)

---

## **Homepage**

[https://github.com/MartinPham/kindle-calendar](https://github.com/MartinPham/kindle-calendar)

## **Features**

- Fullscreen calendar display

- Very low battery usage

- Support localization

- Display random quotes

**To suggest anything, please join our [Discussion board](https://github.com/MartinPham/kindle-calendar/discussions).**

## **Usage**

You need to jailbreak your Kindle! [Here](https://www.mobileread.com/forums/showthread.php?t=320564) you can find the tutorials and tools needed.

After jailbreaking, you can install [USBNetwork](https://www.mobileread.com/forums/showthread.php?t=225030) to SSH into your Kindle.

### **Installation**

- [Download](https://github.com/MartinPham/kindle-calendar/archive/refs/heads/main.zip) this repository.

- Plug in your Kindle to your computer USB.

- Copy `extensions/calendar` into `extensions/calendar` directory on your Kindle.

(If you're using SSH, you could copy `extensions/calendar` into `/mnt/us/extensions/calendar`)

### **Configuration**

- To change day names, month names, and quotes, you can edit  `extensions/calendar/weekdays.txt`, `extensions/calendar/months.txt` and `extensions/calendar/quotes.txt`

- Adjust configurations on `extensions/calendar/config.sh` to match your device.

- SSH into your Kindle.

- Invoke `mntroot rw` to mount filesystem into writable mode.

- Invoke `cd /mnt/us/extensions/calendar/ && sh update.sh` to see if your configurations work properly.

- Invoke `cp /mnt/us/extensions/calendar/calendar.conf /etc/upstart/` to set it auto start on reboot 

- To disable, place an empty file named `DISABLE` on `extensions/calendar` directory (`/mnt/us/extensions/calendar/` if you're using SSH)

- Restart your Kindle and enjoy!

## **Contributing**

Please contribute using [GitHub Flow](https://guides.github.com/introduction/flow). Create a branch, add commits, and then [open a pull request](https://github.com/MartinPham/kindle-calendar/compare).

## **License**

This project is licensed under the [GNU General Public License v3.0](https://opensource.org/licenses/gpl-3.0.html) - see the [`LICENSE`](LICENSE) file for details.