Skip to content

Latest commit

 

History

History
75 lines (51 loc) · 3.4 KB

README.md

File metadata and controls

75 lines (51 loc) · 3.4 KB
Raw

OpenAudible for Docker

This container runs OpenAudible with its GUI accessible by browser.

This is an experimental alternative to the supported and recommended desktop binaries available at openaudible.org.

This project is hosted on github and dockerhub

This project is based on the excellent linuxserver.io/webtop remote desktop container.

Description

OpenAudible runs on Linux, Mac, and Windows. This Docker container runs the latest linux version in a container running Ubuntu that is via web browser. It uses webtop by linuxserver.io.

This allows you to run OpenAudible from a container, on the cloud, or from any Docker capable system (NAS system?).

No passwords are needed to access the web page (so use care!). For personal use. Only one user can view web sessions at one time-so this can't be used to share the application with multiple viewers at the same time.

You may want to map the volume /root/openaudible to access downloaded and converted audiobooks.

Quick Start

docker run -d --rm -it -p 3000:3000 --security-opt seccomp=unconfined --name openaudible openaudible/openaudible:latest

Then open your web browser to http://localhost:3000

You'll probably want to access the volume where OpenAudible saves books.

Building and running from source

git clone https://github.com/openaudible/openaudible_docker.git 
cd openaudible_docker
./run.sh

The run.sh file builds and runs the docker image. You may want to modify it to expose the OPENAUDIBLE volume. Note: The latest version requires the docker run to include --security-opt seccomp=unconfined in the arguments. Without that, you would need to start OpenAudible manually, which can be done via:

./bash.sh
su abc
OpenAudible

If successful, the application will be up and running on port 3000 and accessible via http://localhost:3000 in a browser.

The -rm flag removes the container when it quits. Any downloaded or converted books will be in the docker Volume.

Known limitations:

  • Another user logging on to the web page disconnects anyone else already connected
  • No password protection is offered or https proxy-but can be added.
  • But it does allow a user to try the software in a containerized, accessible-from-anywhere way.

TODO items

  • Perhaps experiment with Ubuntu Kiosk Mode, to disable terminal, su, etc?
  • lock down "su" root ability (change root password?)
  • Document how to access the "config" volume so you can access any converted books from the host machine.

Notes

  • This is experimental and unsupported. We hope some people find it useful.
  • If you find any issues, please report them on github.com/openaudible/openaudible_docker/issues.
  • Before deleting the container and volume, if you logged into Audible, you should Log out using the Control Menu, which will delete your virtual device.
  • Would appreciate feedback or pull requests.
  • Docker is great for testing something, but we still recommend the desktop app for most users.

License

This repository is licensed under the GNU GPL 3.0 because that is what docker-webtop uses.

The OpenAudible desktop application is free to try shareware.