{"id":16648687,"url":"https://github.com/clach04/sample_reading_media","last_synced_at":"2025-09-13T03:32:32.410Z","repository":{"id":65263712,"uuid":"404940987","full_name":"clach04/sample_reading_media","owner":"clach04","description":"Test sample ebooks and comics in txt, rtf, epub, fb2, pdf, CBR, CBZ, CBT, CB7, etc. format.","archived":false,"fork":false,"pushed_at":"2024-06-30T17:07:24.000Z","size":1200,"stargazers_count":9,"open_issues_count":5,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-12-30T01:41:47.347Z","etag":null,"topics":["epub","fb2","fb2-book","markdown","md","pdf","rtf","text","txt"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/clach04.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,"publiccode":null,"codemeta":null}},"created_at":"2021-09-10T03:12:53.000Z","updated_at":"2024-12-19T15:36:51.000Z","dependencies_parsed_at":"2024-10-28T11:26:22.934Z","dependency_job_id":"9f344bc8-cdc0-4a82-acfb-b32e1bcd1dbb","html_url":"https://github.com/clach04/sample_reading_media","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clach04%2Fsample_reading_media","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clach04%2Fsample_reading_media/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clach04%2Fsample_reading_media/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clach04%2Fsample_reading_media/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/clach04","download_url":"https://codeload.github.com/clach04/sample_reading_media/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":232815349,"owners_count":18580566,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["epub","fb2","fb2-book","markdown","md","pdf","rtf","text","txt"],"created_at":"2024-10-12T09:05:15.368Z","updated_at":"2025-09-13T03:32:32.287Z","avatar_url":"https://github.com/clach04.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sample reading media\n\n  * [Overview](#overview)\n  * [Applications to read sample media](#applications-to-read-sample-media)\n  * [Build setup](#build-setup)\n  * [Other media samples](#other-media-samples)\n    + [ebooks](#ebooks)\n    + [Comics](#comics)\n    + [Images](#images)\n    + [Videos](#videos)\n  * [TODO](#todo)\n\n\n## Overview\n\nSuper small, sample ebooks that are representative samples of book formats (and content).\n\nPre-built files ready for download available from https://github.com/clach04/sample_reading_media/releases/\n\nTest sample ebooks, etc. Formats:\n\n  * test_book.md\n  * test_book_md.md\n  * test_book_txt.txt\n  * test_book_txt_crlf_win.txt\n  * test_book_txt_lf_unix.txt\n  * test_book_html.html\n  * test_book_odt.odt\n  * test_book_docx.docx\n  * test_book_pdf.pdf\n  * test_book_fb2.fb2\n  * test_book_epub.epub\n  * test_book_md_zip.zip\n  * test_book_txt_zip.zip\n  * test_book_html_zip.zip\n  * test_book_fb2_zip.zip\n  * test_book_rtf.rtf\n  * test_book_rtf_zip.zip\n\nAll the above sample books are generated from [test_book.md](./test_book.md).\n\n  * source_test_book_fb2.fb2\n  * source_test_book_fb2_zip.fbz\n  * source_test_book_fb2_dot_zip.fb2.zip\n  * test_book_epub_more_detail.epub\n  * test_book_pdf_more_detail.pdf\n\nLGPL license, so feel free to use in/with your projects. If you modify them, share your changes.\n\nTest sample comics, Formats:\n\n  * bobby_make_believe_sample.cb7\n  * bobby_make_believe_sample.cbt\n  * bobby_make_believe_sample.cbz\n  * bobby_make_believe_sample.cbr\n  * bobby_make_believe_sample_dir.cb7\n  * bobby_make_believe_sample_dir.cbt\n  * bobby_make_believe_sample_dir.cbz\n\nImages in comics typically in root directory of archive (see `bobby_make_believe_sample`). `bobby_make_believe_sample_dir` sample have images in a sub-directory.\n\nFor other Comic book samples, see [Comics](#comics).\n\n[bobby_make_believe images](images/bobby_make_believe) are in the Public Domain and are the first 4 four pages of \"Bobby Make-Believe (1915)\" from https://comicbookplus.com/?dlid=26481 - 4 pages to reduce file size whilst being realistic content.\n\n## Applications to read sample media\n\nSee:\n\n  * https://github.com/clach04/dir2opds/wiki\n  * https://github.com/clach04/dir2opds/wiki/Tested-Clients\n\n## Build setup\n\n    # Assuming Debian based\n    sudo apt install pandoc\n    sudo apt install wkhtmltopdf  # for pdf support\n    sudo apt install xvfb  # *might* be needed for wkhtmltopdf\n    sudo apt install wget  # for extra cbz comic\n    sudo apt install p7zip-full  # for cb7 comic (also default for zip and CBZ)\n    sudo apt install zip  # optional, can be used instead of 7z\n    sudo apt install rar  # for cbr comic\n\nAlternative/minimal build:\n\n    env SKIP_COMICS=true env SKIP_PDF=true env SKIP_PANDOC_EOL=true ./build.sh\n\nIssue build:\n\n    ./build.sh\n\nIf wkhtmltopdf needs a display (not an issue under Microsoft Windows builds of Pandoc) can either try and use a diffrent PDF engine for pandoc or use Xvfb, for example:\n\n    Xvfb :1 \u0026\n    env  DISPLAY=:1 ./build.sh\n    # killall Xvfb\n\n### Windows Build\n\nSample Windows build with 7-zip and MSYS2\n\n    path %PATH%;C:\\msys32_32bit\\usr\\bin\\\n    path %PATH%;C:\\Program Files\\7-Zip\\\n\n    C:\\msys32_32bit\\usr\\bin\\bash.exe build.sh SKIP_COMICS\n\n    C:\\msys32_32bit\\usr\\bin\\bash.exe\n\n    env SKIP_COMICS=true sh build.sh\n\n\n## Other media samples\n\n### ebooks\n\n  * https://github.com/koreader/test-data\n  * ebook (epub, mobi and azw3 formats) https://github.com/regueiro/spring-reference-ebook\n  * https://github.com/DistriNet/evil-epubs\n  * https://github.com/jorisschellekens/borb-pdf-corpus\n  https://github.com/chriskempson/portable-humble-little-ruby-book - .mobi,.epub, and .pages source\n\n### Comics\n\n  * [Bobby Make-Believe (1915)](https://comicbookplus.com/?dlid=26481)\n  * Comics (images) https://digitalcomicmuseum.com/index.php?cid=74\n  * https://www.contrapositivediary.com/?p=1197\n      * http://www.copperwood.com/pub/Elf%20Receiver%20Radio-Craft%20August%201936.cbz\n\n### Images\n\n  * Images https://github.com/recurser/exif-orientation-examples\n  * Images https://sourceforge.net/p/exiftool/code/ci/master/tree/t/images/\n  * https://github.com/NaturalHistoryMuseum/SMALL_TAGGED_GEOREF\n  * https://github.com/NaturalHistoryMuseum/ClaytonHerbarium-imgs/tree/master/imgs\n  * https://github.com/NaturalHistoryMuseum/DuxburyCollectionImgs\n      * https://github.com/orgs/NaturalHistoryMuseum/repositories?type=all\u0026q=img\n\n### Videos\n\n  * Video https://github.com/joshuatz/video-test-file-links\n\n\n## TODO\n\n  * add images (e.g. to html, embedded and linked, epub, new md file with images etc.) SpaceX images supposed to be PD https://www.flickr.com/photos/spacex/ (see https://99designs.com/blog/resources/public-domain-image-resources/)\n  * fb2 with title page/images\n  * TOC for epub `pandoc -o OUTPUTNAME.epub INPUTNAME.md --toc --toc-depth=2 --epub-cover-image=COVERIMAGE.png`\n  * regular epub (done)\n  * epub - stored (no-compression)\n  * epub - maximum compression\n  * hand crafted html (e.g. include metadata)\n  * mobi\n  * prc/pdb? - https://github.com/clach04/pyrite-publisher\n  * azw\n  * azw3\n  * add comics\n      * with PNG images (done)\n      * 24-bit, 8-bit grayscale, indexed (e.g. 4 colors), and a transparency test\n      * epub with images only\n      * No compression (done)\n      * with multiple sub-directories\n  * metadata for formats that support it\n      * mobi\n      * azw/azw3\n      * Comic metadata; zip comment or a ComicInfo.xml - see\n          * https://github.com/dickloraine/EmbedComicMetadata\n          * https://github.com/comictagger/comictagger\n          * https://code.google.com/archive/p/comicbookinfo/ (wiki)\n          * https://wiki.mobileread.com/wiki/CBR_and_CBZ#Metadata\n  * Names of ZIP files suitable for KoReader - depending on discoveries in https://github.com/koreader/koreader/issues/9986 (done)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclach04%2Fsample_reading_media","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclach04%2Fsample_reading_media","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclach04%2Fsample_reading_media/lists"}