From 1ac41acdf8e5b492f692251230fc2235cd7e3dd3 Mon Sep 17 00:00:00 2001 From: cody conder Date: Thu, 27 Nov 2025 18:45:44 -0600 Subject: [PATCH] Added OpenAudible --- apps/openaudible/config.json | 31 ++++++++ apps/openaudible/docker-compose.json | 18 +++++ apps/openaudible/docker-compose.yaml | 12 ++++ apps/openaudible/metadata/description.md | 91 ++++++++++++++++++++++++ apps/openaudible/metadata/logo.svg | 13 ++++ 5 files changed, 165 insertions(+) create mode 100644 apps/openaudible/config.json create mode 100644 apps/openaudible/docker-compose.json create mode 100644 apps/openaudible/docker-compose.yaml create mode 100644 apps/openaudible/metadata/description.md create mode 100644 apps/openaudible/metadata/logo.svg diff --git a/apps/openaudible/config.json b/apps/openaudible/config.json new file mode 100644 index 0000000..110693c --- /dev/null +++ b/apps/openaudible/config.json @@ -0,0 +1,31 @@ +{ + "$schema": "../app-info-schema.json", + "name": "OpenAudible", + "port": 3000, + "available": true, + "exposable": true, + "dynamic_config": true, + "id": "openaudible", + "tipi_version": 24, + "version": "4.6.7", + "categories": ["entertainment"], + "description": "OpenAudible is a cross-platform audiobook manager designed for Audible users. Manage/Download all your audiobooks with this easy-to-use desktop application", + "short_desc": "OpenAudible is a cross-platform audiobook manager designed for Audible users. Manage/Download all your audiobooks with this easy-to-use desktop applicationOpenAudible is a cross-platform audiobook manager designed for Audible users. Manage/Download all your audiobooks with this easy-to-use desktop application", + "author": "OpenAudible", + "source": "https://github.com/openaudible/openaudible_docker", + "website": "https://openaudible.org", + "form_fields": [ + { + "type": "text", + "label":"rootPath", + "min":1, + "default":"${APP_DATA_DIR}", + "env_variable":"ROOTPATH" + } + ], + "gid": 1000, + "uid":1000, + "supported_architectures": ["amd64"], + "created_at": 1691943801422, + "updated_at": 1760070985003 +} diff --git a/apps/openaudible/docker-compose.json b/apps/openaudible/docker-compose.json new file mode 100644 index 0000000..76cbafe --- /dev/null +++ b/apps/openaudible/docker-compose.json @@ -0,0 +1,18 @@ +{ + "services": [ + { + "name": "openaudible", + "image": "openaudible/openaudible:latest", + "isMain": true, + "internalPort": 3000, + "environment": {}, + "volumes": [ + { + "hostPath": "${ROOTPATH}", + "containerPath": "/root/OpenAudible" + } + ] + } + ], + "$schema": "https://schemas.runtipi.io/dynamic-compose.json" +} diff --git a/apps/openaudible/docker-compose.yaml b/apps/openaudible/docker-compose.yaml new file mode 100644 index 0000000..9d889d1 --- /dev/null +++ b/apps/openaudible/docker-compose.yaml @@ -0,0 +1,12 @@ +services: + openaudible: + volumes: + - '${ROOTPATH}:/root/OpenAudible' + ports: + - '3000:3000' + environment: + PGID: '1000' + PUID: '1000' + container_name: openaudible + image: 'openaudible/openaudible:latest' + restart: unless-stopped diff --git a/apps/openaudible/metadata/description.md b/apps/openaudible/metadata/description.md new file mode 100644 index 0000000..ea49fb1 --- /dev/null +++ b/apps/openaudible/metadata/description.md @@ -0,0 +1,91 @@ +# OpenAudible for Docker + +This container runs [OpenAudible](https://openaudible.org) with its GUI accessible by browser. + +This is an experimental alternative to the supported and recommended desktop binaries available at [openaudible.org](https://openaudible.org). + +This project is hosted on [github](https://github.com/openaudible/openaudible_docker) and [dockerhub](https://hub.docker.com/r/openaudible/openaudible) + +This project is based on the excellent [https://www.kasmweb.com/kasmvnc](https://www.kasmweb.com/kasmvnc) 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. + +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, but a password can be added by modifying the "run.sh" file. + +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](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. +## Upgrade the Application +To upgrade, you'll need to stop and delete (rm) the container, then restart using the same command you used to start it. +Then when you launch the web page http://localhost:3000 the latest version will be downloaded and installed. + +``` +docker stop openaudible +docker rm openaudible +docker run -d --rm -it -p 3000:3000 --security-opt seccomp=unconfined --name openaudible openaudible/openaudible:latest +``` + +Alternately, you can download and run the OpenAudible installer and not update the web linux environment: +``` +curl -OL https://openaudible.org/latest/OpenAudible_x86_64.sh +chmod +x OpenAudible_x86_64.sh +./OpenAudible_x86_64.sh +# If successful, delete installer file: +rm ./OpenAudible_x86_64.sh +``` + + +## 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 +* 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](https://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 +The OpenAudible desktop application is free to try shareware. diff --git a/apps/openaudible/metadata/logo.svg b/apps/openaudible/metadata/logo.svg new file mode 100644 index 0000000..b1f567c --- /dev/null +++ b/apps/openaudible/metadata/logo.svg @@ -0,0 +1,13 @@ + + + + + + + + + + + + +