{"id":22824899,"url":"https://github.com/sebersta/web-screenshot-server","last_synced_at":"2026-05-02T13:31:12.834Z","repository":{"id":218814029,"uuid":"747062954","full_name":"sebersta/web-screenshot-server","owner":"sebersta","description":"Periodically capture screenshots of a webpage and serve them through a web service. Works with Kindle Online Screensaver.","archived":false,"fork":false,"pushed_at":"2024-02-08T06:00:22.000Z","size":8,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-31T00:23:35.422Z","etag":null,"topics":["docker","kindle","screenshot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sebersta.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":"2024-01-23T07:30:23.000Z","updated_at":"2024-01-24T05:31:42.000Z","dependencies_parsed_at":"2024-01-26T05:38:40.363Z","dependency_job_id":null,"html_url":"https://github.com/sebersta/web-screenshot-server","commit_stats":null,"previous_names":["sebersta/web-screenshot-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sebersta/web-screenshot-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebersta%2Fweb-screenshot-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebersta%2Fweb-screenshot-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebersta%2Fweb-screenshot-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebersta%2Fweb-screenshot-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sebersta","download_url":"https://codeload.github.com/sebersta/web-screenshot-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebersta%2Fweb-screenshot-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32536476,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T12:25:33.646Z","status":"ssl_error","status_checked_at":"2026-05-02T12:24:51.733Z","response_time":132,"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":["docker","kindle","screenshot"],"created_at":"2024-12-12T17:08:47.520Z","updated_at":"2026-05-02T13:31:12.755Z","avatar_url":"https://github.com/sebersta.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Web Screenshot Server\nPeriodically capture screenshots of a webpage and serve them through a web service. It supports various resolutions, rotation, zooming, and grayscale.\n\n## Installation\n### docker-compose\nA docker-compose.yml file is available as an example. It must be edited to match your needs. You probably want to adjust the port mapping and environment variables.\n\n\u003e *Note:* If you are running it on macOS, you have to disable Airplay Receiver in Settings.\n```\nversion: '3.8'\n\nservices:\n  web-screenshot-server:\n    image: sebersta/web-screenshot-server\n    ports:\n      - 5000:5000\n    environment:\n      - URL=https://example.com\n      - RESOLUTION=1488x1072\n      - ROTATION=-90         \n      - ZOOM=200%           \n      - GRAYSCALE=True\n      - WAIT_TIME=2       \n      - UPDATE_INTERVAL=30 \n    restart: unless-stopped\n```\n#### Environment variables\n- `URL`: The web page URL to capture screenshots from.\n- `RESOLUTION`: The resolution for the screenshot (width x height).\n- `ROTATION`: Rotation angle for the image (anticlockwise). \n- `ZOOM`: The zoom level for the web page.\n- `GRAYSCALE`: Convert the screenshot to grayscale if set to True.\n- `WAIT_TIME`: The time in seconds to wait for the web page to load before capturing the screenshot.\n- `UPDATE_INTERVAL`: The interval in seconds at which to update and recapture the screenshot.\n\nThen lauch the container:\n\n```\ndocker-compose up -d\n```\n\n## Integration with Kindle\nWeb Screenshot Server is designed to be work with a jailbroken Kindle and [Online Screensaver](https://www.mobileread.com/forums/showthread.php?t=236104).\nThe Web Screenshot Server captures screenshots and makes them available for download on the Kindle. The Online Screensaver, running on the Kindle, fetches these images and uses them as the Screensaver.\n\n### Instructions\n- Set `RESOLUTION` to match the exact physical resolution of your specific Kindle model. For instance, the Kindle Voyage has a resolution of `1488x1072`.\n- Set `GRAYSCALE` to `True`.\n- For landscape usage, set `ROTATION` to either -90 or 90.\n- To use it with landscape, set `ROTATION` to `-90` or `90`.\n- Set `ZOOM` to your preference.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsebersta%2Fweb-screenshot-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsebersta%2Fweb-screenshot-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsebersta%2Fweb-screenshot-server/lists"}