Digital Raws: Difference between revisions

From Yuri Project
→‎Bookwalker: Add screenshots
Line 62: Line 62:
These instructions apply to the latest version at the time of writing, version <code>0.3.3</code>:
These instructions apply to the latest version at the time of writing, version <code>0.3.3</code>:


# Buy the manga on Bookwalker. For most Japanese releases, you will need to use the Japanese site, not the global site.
# [[File:BookwalkerDownloaderSized.webp|right|200px|thumb|Bookwalker window sized for downloading]]Buy the manga on Bookwalker. For most Japanese releases, you will need to use the Japanese site, not the global site.
# Download https://github.com/xuzhengyi1995/Manga_downloader/releases/latest
# Download https://github.com/xuzhengyi1995/Manga_downloader/releases/latest
# Unzip the file <code>BW-downloader-chrome-bin.zip</code>.
# Unzip the file <code>BW-downloader-chrome-bin.zip</code>.
Line 75: Line 75:
# If you can get the script to automatically click (step 6 [https://github.com/xuzhengyi1995/Manga_downloader?tab=readme-ov-file#old-version here]), that's good, but it is not working at the time of writing due to Bookwalker code changes.
# If you can get the script to automatically click (step 6 [https://github.com/xuzhengyi1995/Manga_downloader?tab=readme-ov-file#old-version here]), that's good, but it is not working at the time of writing due to Bookwalker code changes.
# Instead, you can just click through the manga you are ripping, one page at a time (giving each page enough time to load).
# Instead, you can just click through the manga you are ripping, one page at a time (giving each page enough time to load).
# After you've clicked through all the pages you want to rip, the pages will be in <code>C:\bw_export_data</code> under a folder with a name matching the ID in the Bookwalker URL.
# [[File:BookwalkerDownloadedFolder.webp|right|200px|thumb]] After you've clicked through all the pages you want to rip, the pages will be in <code>C:\bw_export_data</code> under a folder with a name matching the ID in the Bookwalker URL.
 
 


=== Creating a shortcut ===
=== Creating a shortcut ===
[[File:Bookwalker_Chromium_Shortcut.webp|200px|thumb|right|Creating a shortcut for Bookwalker downloader Chromium]]


To create a shortcut that launches the modified Chromium application with the appropriate permissions:
To create a shortcut that launches the modified Chromium application with the appropriate permissions:

Revision as of 04:27, 30 December 2024

The first step in the process of scanlating any manga is obtaining the raws. The first step is to download the file the raws are in, then the second step is to extract the raws from this file.

After extraction, they made need to be post-processed.

Online Sources

Raws can often be found on piracy websites dedicated to hosting them (none are listed here to avoid link rot, but they can be found on the Internet). Be aware that some websites will add watermarks; since it is best practice to not keep watermarks from these sites (the only kind of acceptable watermark is an author watermark), one will either have to manually clean them or find a different source.

Screenshotting

Usually an easy way, but can be low quality due to the resampling that may occur, and is labor-intensive.

PDF

PDF raws are most common when obtaining self-published raws from websites such as https://booth.pm/en

Most raw PDFs are single pages with the images embedded in each page. So the next step is to extract the images that are embedded. There are two tools that are often used.

  1. pdfcpu
    1. Install pdfcpu
      https://github.com/pdfcpu/pdfcpu/releases/latest
    2. Ensure the executable's directory is on your PATH variable
    3. Open the directory the PDF file is in
    4. Run $ pdfcpu.exe images extract .\RAW_INPUT.pdf
      This will output the files in the same directory as the file. To change the output directory, append an output directory path to the command.
  2. Poppler Tools' pdfimages tool
    1. Install Poppler Tools
      Linux
      https://poppler.freedesktop.org/
      Windows
      https://github.com/oschwartz10612/poppler-windows/releases
      OSX
      https://formulae.brew.sh/formula/poppler
    2. Ensure the bin directory is on your PATH variable
    3. Open the directory the PDF file is in
    4. Run $ pdfimages -png RAW_FILE.pdf ./
      This will output the files in the same directory as the file. Change the final argument to change the path of the output directory.

Amazon

This requires extremely light knowledge of Python. No code is required.

  1. Buy the manga (on Amazon)
  2. Go to your content library
  3. Find the manga
  4. Select "Download & transfer via USB" and download the archive
  5. Download Python
  6. Ensure Python is on your PATH variable in some way
  7. Clone the https://github.com/kevinhendricks/KindleUnpack git repo
  8. Open the KindleUnpack directory in a terminal
  9. Run $ python .\KindleUnpack.pyw
  10. A GUI should appear
  11. Select the Kindle file as the "input file"
  12. Select the output directory
  13. Check "Use HD Images If Present"
  14. Click the "Start" button
    Successful Kindle archive extraction
  15. The file will be extracted to the output directory. It will have several directories, but within at least one somewhere there will be an image directory with the extracted images.
    One possible location, the images may be elsewhere within the directory structure depending on the type of archive, and how it was put together.

Bookwalker

This requires downloading a modified Chromium executable on a Windows computer and the ability to run a PowerShell command.

Warning: The Chromium client downloaded here bypasses safety features and should not be used for anything other than downloading manga from Bookwalker.

These instructions apply to the latest version at the time of writing, version 0.3.3:

  1. Bookwalker window sized for downloading
    Buy the manga on Bookwalker. For most Japanese releases, you will need to use the Japanese site, not the global site.
  2. Download https://github.com/xuzhengyi1995/Manga_downloader/releases/latest
  3. Unzip the file BW-downloader-chrome-bin.zip.
  4. Open a powsershell or cmd in the unzipped browser dir:
    1. Navigate to the unzipped directory in explorer.
    2. Shift + right-click in the folder.
    3. Select "Open PowerShell window here".
  5. Open the browser with command line: .\chrome.exe --user-data-dir=c:\bw-downloader-profile --no-sandbox
  6. Log into you Bookwalker account in the launched Chromium window.
  7. Open the book you want to rip in the viewer.
  8. Adjust the window so exactly one page is visible.
  9. If you can get the script to automatically click (step 6 here), that's good, but it is not working at the time of writing due to Bookwalker code changes.
  10. Instead, you can just click through the manga you are ripping, one page at a time (giving each page enough time to load).
  11. After you've clicked through all the pages you want to rip, the pages will be in C:\bw_export_data under a folder with a name matching the ID in the Bookwalker URL.


Creating a shortcut

Creating a shortcut for Bookwalker downloader Chromium

To create a shortcut that launches the modified Chromium application with the appropriate permissions:

  1. Right-click on chrome.exe and select "Create shortcut".
  2. Right-click on the new shortcut and select "Properties".
  3. Select "Target" and move the cursor to the end.
  4. Paste --user-data-dir=c:\bw-downloader-profile --no-sandbox (including the space before)
  5. The new "Target" should look like C:\path\to\Chrome-bin\chrome.exe --user-data-dir=c:\bw-downloader-profile --no-sandbox.