{"id":16366014,"url":"https://github.com/captn3m0/cosmere-books","last_synced_at":"2026-02-17T03:30:14.876Z","repository":{"id":24968187,"uuid":"102870025","full_name":"captn3m0/cosmere-books","owner":"captn3m0","description":"Script to build EPUB/MOBI/PDF versions of various books by Brandon Sanderson","archived":false,"fork":false,"pushed_at":"2025-02-19T13:13:30.000Z","size":10711,"stargazers_count":44,"open_issues_count":4,"forks_count":9,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-19T14:25:15.690Z","etag":null,"topics":["brandon-sanderson","calibre","converts","cosmere","ebook-generator","epub","html","mobi","mythwalker","pdf","stormlightachives","tor","warbreaker"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"wtfpl","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/captn3m0.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"COPYING","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},"funding":{"ko_fi":"captn3m0","liberapay":"captn3m0","github":"captn3m0"}},"created_at":"2017-09-08T14:27:29.000Z","updated_at":"2025-02-19T13:13:27.000Z","dependencies_parsed_at":"2024-08-05T08:00:50.766Z","dependency_job_id":"1b0e59fc-69c3-4232-b184-3bdc8a2c4da6","html_url":"https://github.com/captn3m0/cosmere-books","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/captn3m0%2Fcosmere-books","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/captn3m0%2Fcosmere-books/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/captn3m0%2Fcosmere-books/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/captn3m0%2Fcosmere-books/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/captn3m0","download_url":"https://codeload.github.com/captn3m0/cosmere-books/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239826164,"owners_count":19703439,"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":["brandon-sanderson","calibre","converts","cosmere","ebook-generator","epub","html","mobi","mythwalker","pdf","stormlightachives","tor","warbreaker"],"created_at":"2024-10-11T02:45:01.295Z","updated_at":"2026-02-17T03:30:14.837Z","avatar_url":"https://github.com/captn3m0.png","language":"HTML","funding_links":["https://ko-fi.com/captn3m0","https://liberapay.com/captn3m0","https://github.com/sponsors/captn3m0"],"categories":[],"sub_categories":[],"readme":"# cosmere-books ![Docker Cloud Build Status](https://img.shields.io/docker/cloud/build/captn3m0/cosmere-books) ![Docker Pulls](https://img.shields.io/docker/pulls/captn3m0/cosmere-books) ![Docker Image Size (tag)](https://img.shields.io/docker/image-size/captn3m0/cosmere-books/latest) ![GitHub](https://img.shields.io/github/license/captn3m0/cosmere-books) ![GitHub last commit](https://img.shields.io/github/last-commit/captn3m0/cosmere-books)\n\n![Books in the Cosmere](https://i.imgur.com/NymmBq4.png)\n\nScripts to generate books from the [Cosmere](https://coppermind.net/wiki/Cosmere) using various public sources. Currently supports the following books:\n\n**Books**\n\n1.  Wind and Truth (being serialized till Chapter 30, In Progress)\n1.  Rhythm of War (Serialized till Chapter 18) (with Annotations and Illustrations)\n1.  Oathbringer (Serialized till Chapter 32)\n1.  Warbreaker Prime: Mythwalker\n1.  Skyward (Serialized till Chapter 15)\n1.  The Lost Metal (To be serialized till Chapter 9, In Progress)\n\n**Short Stories**\n\n1.  Defending Elysium\n\n**Graphic Novels**\n\n1.  Dark One (Preview Chapter)\n\n**Tor.com Rereads**\n1.  Way of Kings Reread\n1.  Words of Radiance Reread\n1.  Edgedancer Reread\n1.  Oathbringer Reread\n\nFor obvious reasons, the converted ebooks are not part of this repo. You must download and run the script on your own machine to generate the ebook files.\n\n## Requirements\n\n[Docker](https://docs.docker.com/install/) installed.\n\n## Generation\n\n**Instructions are available for [Windows](https://github.com/captn3m0/cosmere-books/wiki/Running-on-Windows), [Mac](https://github.com/captn3m0/cosmere-books/wiki/Running-on-Mac), and [Linux](https://github.com/captn3m0/cosmere-books/wiki/Running-on-Linux)**.\n\n## Book Codes\n\n```\ndark-one\nedgedancer-reread\nmythwalker\noathbringer\noathbringer-reread\nrow\nskyward\nwok-reread\nwor-reread\nlost-metal\n```\n\nIf none is passed, all books will be generated. The entire build (for all books combined) roughly takes 15 minutes on a single core system (excluding the Docker pull). Generating the `defending-elysium` ebook requires generating all ebooks currently.\n\nAs an example, you'd like to get a ebook for Rhythm of War, run the following command:\n\n  docker run --rm --volume \"$(pwd):/output\" captn3m0/cosmere-books:latest row\n\nFor directions specific to your OS, see above.\n\n## Wind and Truth\n\n\u003e Reactor is serializing the new book from now until its release date on\nDecember 6, 2024. A new installment will go live every Monday at 11 AM ET,\nalong with read-along commentary from Stormlight beta readers and Cosmere\nexperts Lyndsey Luther, Drew McCaffrey, and Paige Vest.\n\n## Rhythm of War\n\n\u003eThe chapter-by-chapter serialization of Rhythm of War, Brandon Sanderson’s\n fourth volume in The Stormlight Archive series. New chapters go live every\n Tuesday up to the November 17, 2020 release date.\n\nThis supports the annotations that Brandon is publishing on Reddit along with [3 illustrations from Part 1](https://www.17thshard.com/forum/topic/92967-some-new-illustrations-from-row/). This covers the entire Part 1 of the book.\n\n## Oathbringer\n\nTor.com is published Oathbringer in serialized form till Chapter 32. This\nscript downloads all of these posts and converts them into a publishable\nformat, including epub, mobi, pdf and html. You can find the tor.com\nannouncement at\nhttps://www.tor.com/2017/08/15/brandon-sanderson-oathbringer-serialization-announcement/.\nThis covers the entire Part 1 of the book.\n\n## Way of Kings Reread\n\nJoin Michael Pye (aka The Mad Hatter) and Carl Engle-Laird as they dive into the details of Sanderson’s complex new world of Roshar.\n\nFind out more at \u003chttps://www.tor.com/features/series/the-way-of-kings-reread-on-torcom/\u003e.\n\n## Words of Radiance Reread\n\nWelcome to the reread of Brandon Sanderson’s second Stormlight Archive series book Words of Radiance! This reread will be a collaborative effort between Tor.com’s own editorial assistant Carl Engle-Laird and long-time Tor.com commenter and Sanderson beta-reader Alice Arneson. This new partnership promises to be as potent as that between spren and Radiant. Join them in the Storm Cellar as they evaluate, discuss, question, and generally kibitz their way through the Words of Radiance.\n\nMore details at \u003chttps://www.tor.com/series/words-of-radiance-reread-on-torcom/\u003e\n\n## Edgedancer Reread\n\nJoin Alice Arneson and Lyndsey Luther for a reread of Brandon Sanderson’s Cosmere novella, Edgedancer, which fills in some of the details for Lift and Nalan between their appearances in Words of Radiance and the next time we see them in Oathbringer.\n\nMore details at \u003chttps://www.tor.com/series/edgedancer-reread-brandon-sanderson/\u003e\n\n## Way of Kings: Prime\n\nBrandon published Way of Kings Prime as a free ebook, which you can download from here: https://www.brandonsanderson.com/the-way-of-kings-prime/. It is now available for free in EPUB/MOBI/PDF formats from the link.\n\n## Oathbringer Reread\n\n\u003e Join Alice Arneson and Lyndsey Luther for a reread of Brandon Sanderson’s Oathbringer, the third novel in the Stormlight Archive epic fantasy series.\n\nMore details at https://www.tor.com/series/oathbringer-reread-brandon-sanderson/\n\n## Skyward\n\n\u003e Skyward by #1 New York Times bestselling author Brandon Sanderson is the first book in an epic new series about a girl who dreams of becoming a pilot in a dangerous world at war for humanity’s future. We know you can't wait for the book to finally hit shelves on 11/6/18, so we're releasing new chapters here every week!\n\nSee more details at [underlined](https://www.getunderlined.com/read/excerpt-reveal-start-reading-skyward-by-brandon-sanderson/) or [brandonsanderson.com](https://brandonsanderson.com/books/skyward/skyward/). This covers Chapters 1-15 of the book.\n\n## Defending Elysium\n\n\u003e This story originally appeared in the October/November 2008 Asimov’s Science Fiction (in the US) and the UPC Science Fiction collection (in Europe). It was winner of the UPC science fiction award, and was the last short story Brandon wrote before he sold Elantris to Tor.\n\n\u003e The story was first named honorable mention in a Writers of the Future contest in early 2003. (Brandon got the phone call from an editor buying Elantris in April 2003.) A few years later, he did a couple of serious revisions of the story and then submitted it to the UPC award in Spain. It won first place, and subsequently sold in the US to Asimov’s Science Fiction—which was Brandon’s first (and so far only) fiction appearance in a major print magazine. It was given an honorable mention in Gardner Dozois’s The Year’s Best Science Fiction anthology for 2008.\n\nMore details at https://brandonsanderson.com/defending-elysium/. Annotations at https://brandonsanderson.com/annotation-Recent-Short-Stories-Defending-Elysium/\n\n## Dark One\n\n\u003eBrandon Sanderson’s Dark One is a break from the norm; it’s a graphic novel from Vault Comics, originally announced as being in the works two years ago, based on an original idea from Sanderson. The book will be written by Collin Kelly and Jackson Lanzing from a story by Sanderson, with art by Nathan Gooden and colors from Kurt Michael Russell. Lettering on the project comes from Deron Bennett.\n\n\u003eThe chapter below was originally intended to be Vault Comics’ Free Comic Book Day release this year.\n\nMore details at \u003chttps://www.hollywoodreporter.com/heat-vision/dark-one-excerpt-brandon-sanderson-unveils-fantasy-graphic-novel-1297122\u003e.\n\nThe script generates a CBZ file.\n\n## Warbreaker Prime: Mythwalker\n\nBelow description from [Sanderson's website](https://www.brandonsanderson.com/warbreaker-prime-mythwalker-prologue/), written by Peter:\n\n\u003eWhen Brandon shelved Mythwalker in August 2001 because he felt it wasn’t working (one of its issues was that it felt clichéd, but there are other issues that I’ll discuss following later chapters), he planned to get back to it eventually. But there were still elements and characters left over in those books that could be used to tell other stories. Warbreaker follows one of the storylines from Mythwalker that was left when the elements used in the Mistborn trilogy were taken out. But that is not all that Mythwalker is. Its main character and its magic system have not been cannibalized. What you will read here [...] is an interesting story in its own right, even though it has problems. And some of you will be frustrated that the story remains unfinished.\n\u003e\n\u003eSo it is probably best to view these chapters just as a window on early Brandon Sanderson, when he tried something and failed. This was the first novel in Brandon’s adult writing career that he started writing but never finished. If you want insight into his creative process, I think this is a great place to look.\n\n## The Lost Metal\n\n\u003e Tor.com is serializing The Lost Metal from now until its release on November 15. New chapters will go live every Monday at 12pm ET.\n\nIn progress, only Chapter 1 so far.\n\n## Extra\n\nIf you'd like to see any other books covered here, please [create an issue](https://github.com/captn3m0/cosmere-books/issues/new), or reach out to me: \u003chttps://captnemo.in/contact/\u003e\n\n## Development\n\nIf you'd like to hack on the project locally, see [HACKING.md](HACKING.md).\n\n## LICENSE\n\nThis is licensed under WTFPL. See COPYING file for the full text.\n\n## Other Projects\n\n- Another project that does ebook generation for Warbreaker: https://github.com/guusj/books\n- A list of my other EBook generation projects: https://captnemo.in/ebooks/, includes a link to other related projects as well\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaptn3m0%2Fcosmere-books","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaptn3m0%2Fcosmere-books","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaptn3m0%2Fcosmere-books/lists"}