Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Bill13579/buck

The definitive e-book reader music player (Kobo, Kindle)
https://github.com/Bill13579/buck

Last synced: about 1 month ago
JSON representation

The definitive e-book reader music player (Kobo, Kindle)

Awesome Lists containing this project

README 

        



# Introduction



E-ink devices have traditionally been only for reading... well no more!



**Buck** is a fully-fledged music player for e-ink devices (tested fully for the Kobo Libra 2 and the Kindle Touch).



*Features:*


- Using the generated Table of Contents, pick the song you wanna play






- Afterwards, in the search bar, there are two commands you can do


  `;b` - to open up the GUI


  `;b ` - to play up the track of your choice






- Here's what the GUI looks like


  Tap near the top to control volume and the bottom right to close!






** Playlist support is not planned at the moment



# Installation on (Audiobook-enabled) Kobo devices



1. Stop Nickel from scanning hidden directories (additional info: 1 2)

```

Add



[FeatureSettings]

ExcludeSyncFolders=\\.(?!kobo|adobe).*?



to



(directly through the USB connection) .kobo/Kobo/Kobo eReader.conf

```



2. Setup/enable Bluetooth playback


    1. Enter `devmodeon` in the Kobo search bar

    2. Go to `More > Settings > Device information > IP address`, and take note of the IP

    3. Back on your machine, install `telnet`

    4. Do `telnet `

    5. **From this shell, you can now access /etc/alsa/conf.d/20-bluealsa.conf**

    6. Do `vi /etc/alsa/conf.d/20-bluealsa.conf`

    7. Type `I` on your keyboard to go into insert mode

    8. At the top, add this line: `defaults.bluealsa.device "00:00:00:00:00:00"` 

    9. Do `Esc`, `:wq`, `Enter`

    10. Exit out of the shell `exit`

    11. Enter `devmodeoff` in the Kobo search bar



3. Install NickelMenu



4. Install FBink



5. Install **Buck** using the KoboRoot.tgz file in this repository



**P.S. repeat step 5 for updating Buck!**



# Installation on Kindle Touch (K5)



Requirements:

- USBnet

- KUAL



In the root directory of this repo is a folder named `buck-k5`. That's everything you'll need.



1. Move the `buck-k5` folder to your `/mnt/us/` folder and rename to `buck`


Folder structure:

- `/mnt/us/buck/buck`

- `/mnt/us/buck/buck-cli`

- `/mnt/us/buck/buck-cli.sh`

- `/mnt/us/buck/kual_buck`

- `/mnt/us/buck/assets`

- `/mnt/us/buck/bin`

- `/mnt/us/buck/lib`



2. The KUAL extension


- The `/mnt/us/buck/kual_buck` folder is the KUAL extension, move it to `/mnt/us/extensions`



3. The Search Commands


    1. SSH into your Kindle (you'll need USBnet)

    2. `mntroot rw`

    3. `vi /usr/share/webkit-1.0/pillow/debug_cmds.json`

    4. Add `";b": "/mnt/us/buck/buck-cli.sh"` at the bottom

    5. Reboot your kindle `reboot`



And that's it! You can launch it by typing `;b` or `;b `



In KUAL, you'll also have an option to restart Buck. This is if you add new songs and don't want to reboot.



**A Note About Volume:**


**100% IS PROBABLY NOT THE BEST VOLUME!**


The Kindle Touch is very quiet, and so there is software volume boosting going on.


By default 100% is actually 150%. Although it works for some songs, I recommend


sticking to **about 90%** (although if you know a song works with 100, go for it!)


It gives the best balance between loudness and compatibility with


pretty much all songs. K, have fun listening!



# Credits



The amazing FBInk by NiLuJe. The ability to draw anything on screen is... quite powerful



The built-in `aplayer` is terrible for advanced control of media playback, and so I use mplayer instead.


For the K5 version, I use the great `mplayer` binary built for the K5 by the user `Smarter` in 2011


Link: https://www.mobileread.com/forums/showthread.php?t=119851&highlight=winamp



WMCtrl and the UI disabling scripts by twobob


https://www.mobileread.com/forums/showthread.php?t=194270



Icons:


https://online.rapidresizer.com/photograph-to-pattern.php


https://pixabay.com/vectors/note-sound-music-melody-concert-24074/


https://pixabay.com/photos/reindeer-elk-deer-buck-antlers-5635891/