This is an automated archive made by the Lemmit Bot.
The original was posted on /r/selfhosted by /u/redwoodstory on 2025-01-28 16:07:09+00:00.
LitKeeper
This is a simple web app to save stories from Literotica to ePub. In my own workflow, I download stories to a home server running Calibre-Web-Automated, which renders the stories available to other devices through its OPDS functionality. From there, I can read on my tablet, phone, e-reader, etc.
This app includes the following features:
- Renders a simple web page prompting the user for a Literotica URL to download
- Retrieves story, converts to ePub, and saves to a predefined location (defined in Docker Compose file)
- Bundles story category and tags into metadata
- Generates a cover image showing the story title and author name
- Identifies if the story is part of a series and bundles subquent stories into a single ePub
- Provides an API to download stories directly from iOS shortcuts (useful for my own workflow to browse Literotica, find a story I like, and quickly save to my library via the Share menu)
- (Optional) Sends Telegram notifications when the story is downloaded
- (Optional) Provides somewhat extensive logging (helpful for debugging but can be disabled in Docker Compose file)
This is my first time publishing a docker image, so I look forward to any feedback! Hope this app is useful for others who enjoy the stories on Literotica
services:
litkeeper:
image: ghcr.io/redwoodstory/litkeeper:latest
restart: unless-stopped
ports:
- "5000:5000"
volumes:
- ./epubs:/litkeeper/app/data/epubs
- ./logs:/litkeeper/app/data/logs
environment:
# Optional logging controls
- ENABLE_ACTION_LOG=true # Set to false to disable action logging
- ENABLE_ERROR_LOG=true # Set to false to disable error logging
- ENABLE_URL_LOG=true # Set to false to disable URL logging
# Optional Telegram notification configuration
- TELEGRAM_BOT_TOKEN= # Your bot token from @BotFather
- TELEGRAM_CHAT_ID= # Your chat ID (can be channel, group, or user ID)