{"id":37607145,"url":"https://github.com/bcliang/docker-libgourou","last_synced_at":"2026-01-16T10:13:23.412Z","repository":{"id":37072208,"uuid":"499260193","full_name":"bcliang/docker-libgourou","owner":"bcliang","description":"dockerized version of libgourou (free implementation of Adobe's ADEPT protocol used to manage DRM in ePub/PDF files). ACSM, Adobe Digital Editions, WINE-free","archived":false,"fork":false,"pushed_at":"2024-03-06T17:46:32.000Z","size":32,"stargazers_count":56,"open_issues_count":0,"forks_count":3,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-03-06T19:24:48.539Z","etag":null,"topics":["acsm","adept","adobe-digital-editions","docker"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bcliang.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,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-06-02T19:13:45.000Z","updated_at":"2024-03-06T18:55:51.000Z","dependencies_parsed_at":"2024-03-08T06:33:31.946Z","dependency_job_id":null,"html_url":"https://github.com/bcliang/docker-libgourou","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/bcliang/docker-libgourou","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcliang%2Fdocker-libgourou","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcliang%2Fdocker-libgourou/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcliang%2Fdocker-libgourou/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcliang%2Fdocker-libgourou/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bcliang","download_url":"https://codeload.github.com/bcliang/docker-libgourou/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcliang%2Fdocker-libgourou/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28478049,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T06:30:42.265Z","status":"ssl_error","status_checked_at":"2026-01-16T06:30:16.248Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["acsm","adept","adobe-digital-editions","docker"],"created_at":"2026-01-16T10:13:20.601Z","updated_at":"2026-01-16T10:13:23.392Z","avatar_url":"https://github.com/bcliang.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# docker-libgourou\n\nDockerized version of libgourou. libgourou is a free implementation of Adobe's ADEPT protocol. ADEPT is used to manage loaned ePub/PDF titles (checkout/return). It is also used to manage DRM in loaned ePub/PDF files. \n\n## libgourou\n\nlibgourou requires an Adobe ID but runs on Linux platforms (no WINE-based workaround required).\n\nhttps://indefero.soutade.fr/p/libgourou/\n\n### utils\n\nThis container compiles the reference implementation utilities for libgourou (master branch) and places them in `/usr/local/bin` for easy access. \n\n- `acsmdownloader` for downloading ePub/PDF files from Adobe's CDN\n- `adept_activate` for activating user device via Adobe ID\n- `adept_loan_mgt` for managing ADEPT loan library\n- `adept_remove` for removing ADEPT DRM from an ADEPT-protected ePub/PDF\n\n## Installation\n\n### Local Build\n\n```bash\n\u003e docker build . -f Dockerfile-ubuntu -t bcliang/docker-libgourou\n```\n\nor on alpine:\n```bash\n\u003e docker build . -f Dockerfile-alpine -t bcliang/docker-libgourou\n```\n\n### DockerHub\n\n```bash\n\u003e docker pull bcliang/docker-libgourou:latest\n```\n\nThe `:latest` tag will pull the `:ubuntu` image. Use `:ubuntu` or `:alpine` to specify the desired base image (warning: segmentation faults when running the alpine build in `0.8.4`).\n\n## Usage\n\n### Automated download and de-drm\n\nBy default, the container will process an inputted *.acsm file ($1) through both `acsmdownloader` (to retreive the PDF/ePub file) and `adept_remove` (to remove ADEPT DRM from the downloaded file). \n\n```bash\n\u003e docker run \\\n    -v {$PATH_TO_ADOBE_CREDS}:/home/libgourou/.adept \\\n    -v $(pwd):/home/libgourou/files \\\n    --rm bcliang/docker-libgourou \\\n    [name_of_adept_metafile.acsm]\n```\n\nNotes: \n1. The shell script assumes that activated device configuration files (via Adobe ID credentials) have been mounted into `/home/libgourou` (alternates: `/home/libgourou/.adept/`, `/home/libgourou/adobe-digital-editions/`, etc.). \n2. To generate ADEPT configuration files (`activation.xml`, `devicesalt`, `device.xml`), use the interactive terminal and run the `adept_activate` utility.\n\n### Interactive Terminal\n\nTo manually run libgourou utils, run the container interactively and overide the docker entrypoint:\n```bash\n\u003e docker run \\\n    -v {$PATH_TO_ADOBE_CREDS}:/home/libgourou/.adept \\\n    -v $(pwd):/home/libgourou/files \\\n    -it --entrypoint /bin/bash \\\n    bcliang/docker-libgourou\n```\n\n#### Commands\n\nUse the bash shell to run the libgourou utility scripts. See the `libgourou` [README](https://indefero.soutade.fr/p/libgourou/source/tree/master/README.md) and/or the included manpages for additional usage.\n\nTo activate a new device with a AdobeID :\n```\nadept_activate -u \u003cAdobeID USERNAME\u003e [--output-dir output_directory]\n```\nBy default, configuration files will be saved in `/home/libgourou/.adept`. Users should save contents to a mounted volume for reuse at a later date.\n\nTo download an ePub/PDF :\n```\nacsmdownloader \u003cACSM_FILE\u003e\n```\nTo export your private key (for use with Calibre, for example) :\n```\nacsmdownloader --export-private-key [-o adobekey_1.der]\n```\nTo remove ADEPT DRM :\n```\nadept_remove \u003cencrypted_file\u003e\n```\nTo list loaned books :\n```\nadept_loan_mgt [-l]\n```\nTo return a loaned book :\n```\nadept_loan_mgt -r \u003cid\u003e\n```\n\n### Bash Script\n\nA \"de-DRM\" bash script is provided (`./scripts/dedrm.sh`) to simplify running and using the docker-libgourou image.\n\n```bash\n\u003e chmod +x scripts/dedrm.sh\n\u003e cp scripts/dedrm.sh ~/.local/bin/dedrm\n```\n\nTo launch an interactive terminal with access to the libgourou utils:\n```bash\n\u003e dedrm\n!!!    WARNING: no ADEPT keys detected (argument $2, or \"$HOME_DIR/.config/adept\").\n!!!    Launching interactive terminal for credentials creation (device activation). Run this:\n\n \u003e adept_activate --random-serial \\\n       --username {USERNAME} \\\n       --password {PASSWORD} \\\n       --output-dir files/adept\n\n!!!     (*) use --anonymous in place of --username, --password if you do not have an ADE account.\n!!!     (*) credentials will be saved in the following path: \"$(pwd)/adept\"\n\n!!!    WARNING: no ACSM file detected (argument $1).\n!!!    Launching interactive terminal for manual loan management. Example commands below:\n\n \u003e acsmdownloader \\\n       --adept-directory .adept \\\n       --output-file encrypted_file.drm \\\n       \"files/{ACSM_FILE}\"\n \u003e adept_remove \\\n       --adept-directory .adept \\\n       --output-dir files \\\n       --output-file \"{OUTPUT_FILE}\" \\\n       encrypted_file.drm\n\nMounted Volumes\n   (current path e.g. $pwd) --\u003e /home/libgourou/files/\n\nroot@..:/home/libgourou# \n```\n\nIf you already have ADEPT keys saved (i.e. in `.adept` or `~/.config/adept`), append the encrypted ACSM file path in order to automatically generate a DRM-removed PDF/ePub file (this simply replicates the command at the top of this section):\n```bash\n\u003e dedrm {ACSM_FILE}\n```\n\nTo generate a DRM-free PDF/ePub file using credentials in a specific path:\n```bash\n\u003e dedrm {ACSM_FILE} {CREDENTIALS_PATH}\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbcliang%2Fdocker-libgourou","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbcliang%2Fdocker-libgourou","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbcliang%2Fdocker-libgourou/lists"}