Switch from Goodreads to Ribbon
Ribbon reads the CSV file that Goodreads (and StoryGraph) lets you export. You keep your shelves, ratings, dates and reviews, and nothing is sent to an account.
Step 1. Export your library from Goodreads
- Open the Goodreads website in a browser and sign in. The export is on the website; if you only use the Goodreads app, open goodreads.com in your phone's browser instead.
- Go to My Books.
- Find Import and export (it sits with the tools for your shelves) and open it.
- Choose Export Library.
- Goodreads prepares the file. When it is ready you get a download link, and some accounts also receive it by email. Download the CSV; its name usually starts with goodreads_library_export.
Menu names and the way the file is delivered can change, so if a label looks different, look for the words "export" and "library" on your My Books page.
Step 2. Get the file onto your phone
If you exported on a computer, send the file to yourself by email or put it in a cloud drive, then download it on the phone. Leave it as a CSV; there is no need to open or edit it.
Step 3. Import it in Ribbon
- In Ribbon open Settings and choose Import from Goodreads / StoryGraph.
- Pick the CSV file with the system file picker. Ribbon needs no storage permission for this.
- Ribbon works out whether it is a Goodreads or a StoryGraph file and imports it. When it finishes you see a line such as Imported 312 books · 4 skipped (already here).
What comes across
| In Goodreads | In Ribbon |
|---|---|
| Shelf: read | Read shelf |
| Shelf: currently-reading | Reading shelf |
| Shelf: to-read | Want to read shelf |
| A custom main shelf named dnf, did-not-finish or abandoned | Did not finish shelf |
| Any other custom main shelf | Want to read shelf |
| Your other shelves | Tags on the book |
| My Rating | Your rating |
| Date Read and Date Added | Finished date and added date |
| My Review | Your private review |
| Read Count | Number of times read |
| Title, author, ISBN, pages, publisher, year | The same details on the book |
The CSV only holds your own library, so friends, comments, groups and likes are not part of any export and cannot be imported. Covers are not in the file either; Ribbon looks them up from Open Library using each ISBN.
Coming from StoryGraph
StoryGraph also lets you export your library as a CSV file from your account settings; look for the export option under Manage Account. Download it, then import it in Ribbon exactly as in step 3.
The StoryGraph statuses read, currently reading, to read and did not finish map to the Read, Reading, Want to read and Did not finish shelves. Ratings, reviews, dates, tags and read count come across too.
Taking your data out again
Ribbon can export your library as a CSV with Goodreads-compatible columns, and as a full backup file. Both are saved where you choose, so you are never locked in.
Questions about switching
Will my Goodreads shelves come across?
The three standard shelves map directly: read becomes Read, currently-reading becomes Reading and to-read becomes Want to read. Other shelves you made become tags on the books.
What if I import twice?
Books that are already in Ribbon (same ISBN, or the same title and author) are skipped and counted, so running an import again does not create copies.
Do I need to give Ribbon access to my files or my Goodreads account?
No. Ribbon never asks for your Goodreads login. You choose the CSV file yourself with Android's file picker, and Ribbon reads only that one file.
Why are some covers missing right after the import?
Covers are fetched from Open Library by ISBN, slowly and only while the app is open, starting with the books you can see. They fill in over a few minutes. Books without an ISBN get a generated cover.