{"id":13596097,"url":"https://github.com/kathamer/DebianKindle","last_synced_at":"2025-04-09T16:31:31.520Z","repository":{"id":37491561,"uuid":"90757593","full_name":"kathamer/DebianKindle","owner":"kathamer","description":"Scripts to install Debian on your Kindle","archived":false,"fork":false,"pushed_at":"2020-10-28T15:31:58.000Z","size":97,"stargazers_count":352,"open_issues_count":4,"forks_count":21,"subscribers_count":15,"default_branch":"master","last_synced_at":"2024-11-06T19:40:56.198Z","etag":null,"topics":["debian","kindle","linux","modding"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kathamer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-05-09T14:49:09.000Z","updated_at":"2024-08-06T05:46:29.000Z","dependencies_parsed_at":"2022-09-15T06:50:52.564Z","dependency_job_id":null,"html_url":"https://github.com/kathamer/DebianKindle","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kathamer%2FDebianKindle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kathamer%2FDebianKindle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kathamer%2FDebianKindle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kathamer%2FDebianKindle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kathamer","download_url":"https://codeload.github.com/kathamer/DebianKindle/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248067768,"owners_count":21042352,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["debian","kindle","linux","modding"],"created_at":"2024-08-01T16:02:07.984Z","updated_at":"2025-04-09T16:31:31.102Z","avatar_url":"https://github.com/kathamer.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Installing Debian on your Kindle\n\n# Update (2020): This project is deprecated. I have no idea if any of the following instructions are still accurate, or if any of the links are still working. I have now moved over to [Gitlab](https://gitlab.com/kathamer).\n\n\n## Installing Debian on your Kindle\n\nThe first thing you need to do is jailbreak your Kindle. The jailbreaking process involves allowing the\ninstallation of unsigned applications to your Kindle. I used [this guide from LifeHacker.com](https://www.lifehacker.com.au/2016/07/how-to-jailbreak-your-kindle/)\n\n\nOnce you have jailbroken, you will be able to install a terminal.\nInstalling a terminal allows you to access the underlying Linux system on your Kindle. For this hack, I used KTerm. You can get KTerm from [here.](https://github.com/bfabiszewski/kterm/releases/download/v2.3/kterm-kindle-2.3.zip) To install it, you have to unzip the ZIP file you downloaded into the `extensions` folder on your Kindle's root directory from a computer.\n\nNow that you have a terminal, you will be able to install the Debian chroot. \nHere's where it gets complicated. First, you need to generate a Debian image appropriate for your device. \nUse `MakeImage.sh` to do this. Run the script on a Linux system to generate the image. If you do not have access to a Linux system, message me and I can provide a pre-generated one.\n\nNow, move the `debian.ext3` file on to your Kindle's root directory. You're almost there.\nOnce you have moved `debian.ext3`, you need to move the `RunDebian.sh` script and the `UpdateInitScript.sh` script as well as `RunBeforeDebian.sh`\n\non to your Kindle. Now you can run them. Do this by typing \n`cd ../..` and then `./RunDebian.sh --root` on your Kindle. You are now root on your Kindle!\n\nThen, hit `CTRL-D` on your Kindle until you see `[US]$` or `[US]#` \nyou are now back in your Kindle's terminal. Type `./RunBeforeDebian.sh` on your Kindle to setup mountpoints and install the `debian command/. \nNow, you should be able to type `debian` in the Kindle's terminal to access Debian. \nIf you need root access (to install sudo, add users, etc) type `debian --root` to start Debian as root. \n\nYou should now have a working Debian install. \n\nFinally, you need to setup Debian (IF YOU HAVE A PREGENERATED IMAGE YOU CAN SKIP THIS STEP)\nFirst, type `debian --root` to enter Debian as root.\nThen, type `cd /deboostrap`.\nNext, type `./deboostrap --second-stage` and let that do it's thing.\nIf it fails, hit `CTRL-D` until you see `[US]$` then type `debian  --root` again.\nOnce that completes, type `dpkg --configure -a`.\nNow type `adduser \u003cUSERNAME\u003e` replacing `\u003cUSERNAME\u003e` with your name.\nNext, type `apt-get install sudo`.\nThen, type `adduser \u003cUSERNAME\u003e sudo` replacing `\u003cUSERNAME\u003e` with your name and follow the prompts.\nFinally, hit `CTRL-D` until you see `[US]$` and type `debian`.\nLogin with your username and password.\nFinally, type `echo alias \"sudo\"=\"sudo -S\"`.\n\n-Enjoy!\n\nOpen an issue in the [Issue Tracker](https://github.com/KatHamer/DebianKindle/issues) if you encounter any issues, or\nPM me on Reddit (u/dylanhamer13) if you need help with any of the instructions.\n\nThanks for the support, \nKat\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkathamer%2FDebianKindle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkathamer%2FDebianKindle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkathamer%2FDebianKindle/lists"}