📚 CSV Converter

\n Convert your reading data between Storygraph and Goodreads formats\n

\n\n {conversionState.stage === \"idle\" && (\n <>\n

\n Conversion Direction\n

\n \n \n setDirection(e.target.value as ConversionDirection)}\n />\n Storygraph → Goodreads\n \n \n \n setDirection(e.target.value as ConversionDirection)}\n />\n Goodreads → Storygraph\n \n

\n\n {direction === \"storygraph-to-goodreads\" && (\n

\n 🔍 Enhanced with Goodreads Data\n

\n Your Storygraph export will be automatically enriched with\n Goodreads data to normalize titles, fetch real Goodreads\n Book IDs, and dramatically improve import success rates for\n platforms like BookHive.\n
\n Note:{\" \"}\n This process takes longer as it searches Goodreads for each\n book, but provides much better compatibility.\n

\n )}\n\n

\n Upload CSV File\n fileInputRef.current?.click()}\n >\n

📁

\n Drop your CSV file here or click to browse\n

\n {getFileHint()}\n

\n \n

\n \n )}\n\n {(conversionState.stage === \"uploading\" ||\n conversionState.stage === \"parsing\" ||\n conversionState.stage === \"enriching\" ||\n conversionState.stage === \"converting\" ||\n conversionState.stage === \"saving\") && (\n

\n {conversionState.stage === \"uploading\" && \"📤 Uploading\"}\n {conversionState.stage === \"parsing\" && \"📋 Parsing CSV\"}\n {conversionState.stage === \"enriching\" &&\n \"🔍 Enriching with Goodreads\"}\n {conversionState.stage === \"converting\" &&\n \"🔄 Converting Format\"}\n {conversionState.stage === \"saving\" && \"💾 Saving File\"}\n

\n {conversionState.progress}%\n

\n \n

\n {conversionState.message}\n

\n {conversionState.currentBook && (\n

\n 📖 Processing: {conversionState.currentBook}\n

\n )}\n {conversionState.stats?.totalBooks && (\n

\n Total books: {conversionState.stats.totalBooks}\n

\n )}\n

\n )}\n\n {conversionState.stage === \"complete\" && (\n

\n ✅ Conversion completed!\n

\n\n {conversionState.stats && (\n

\n {conversionState.stats.totalBooks}\n

Total Books

\n {conversionState.stats.successCount}\n

✅ Converted

\n {conversionState.stats.failedCount > 0 && (\n

\n {conversionState.stats.failedCount}\n

❌ Failed

\n )}\n

\n\n {direction === \"storygraph-to-goodreads\" && (\n

\n 🔍 Enhanced with Goodreads data for better BookHive\n compatibility\n

\n )}\n

\n )}\n\n {conversionState.failedBooks &&\n conversionState.failedBooks.length > 0 && (\n

⚠️ Books that couldn't be processed:

\n {conversionState.failedBooks.map((book, index) => (\n

\"{book.title}\"

by {book.author}

\n {book.error && (\n

{book.error}

\n )}\n

\n ))}\n

\n )}\n\n

\n \n 📥 Download {conversionState.filename}\n \n

\n \n Convert Another File\n \n

\n )}\n\n {conversionState.stage === \"error\" && (\n

\n ❌ {conversionState.error}\n

\n \n Try Again\n \n

\n )}\n

\n\n

How to use:

\n Choose conversion direction:{\" \"}\n Select whether you're converting from Storygraph to Goodreads or\n vice versa.\n
\n Upload your CSV:{\" \"}\n Drop your export file or click to browse and select it.\n
\n Download converted file:{\" \"}\n Once processing is complete, download your converted CSV file.\n
\n Import to target platform:{\" \"}\n Use the downloaded file to import your reading data.\n

\n 📝 Note:{\" \"}\n Files are temporarily stored for conversion and automatically deleted\n after 24 hours. No data is permanently stored.\n

\n\n

FAQ

\n\n

\n \n 🤔 Why would you use this?\n \n \n This tool helps you migrate your reading data between platforms like\n Storygraph and Goodreads. It's especially useful for importing into\n newer platforms like{\" \"}\n \n BookHive\n \n , which is open-source and built on decentralized technology where\n you own your data.\n

\n Storygraph conversions are automatically enhanced with Goodreads\n data to dramatically improve import success rates by normalizing\n book titles and fetching proper Goodreads Book IDs that other\n platforms can recognize.\n

\n\n

\n \n ⚙️ How does it work?\n \n

\n The converter parses your CSV export, maps fields between different\n formats, and optionally enriches the data by searching Goodreads for\n complete book information. For Storygraph → Goodreads conversions,\n it automatically looks up each book to get proper Goodreads Book\n IDs, normalized titles, and author names for maximum compatibility\n with import systems.\n

\n\n

\n \n 👨‍💻 Who made this?\n \n

\n Built by{\" \"}\n \n @tijs.org\n {\" \"}\n to help book lovers migrate their reading data between platforms.\n Open source and privacy-focused - your data is processed locally and\n never permanently stored.\n

\n\n

\n \n 🚀 Running on Val Town\n \n \n This tool runs on{\" \"}\n \n Val Town\n \n , a platform for running serverless TypeScript/JavaScript code. Val\n Town makes it easy to deploy and share web applications without\n managing servers.\n

\n Want to customize this tool or run your own version? You can{\" \"}\n \n remix this val\n {\" \"}\n and modify it to suit your needs. The code is open and ready to\n fork!\n

\n \n );\n}\n","deleted","label",[171,172,153],"frontend","components","permalink","https://www.val.town/x/tijs/storygraph-to-goodreads/code/frontend/components/App.tsx","extension","actionData","errors"]