====== Extract images from EPUB files ======

The accessible e-text version of a book needs to include the original ebook's images. To preserve the original image quality, we need to first extract the images from the EPUB and then insert them into the Word document.

<note>If you are dealing with a PDF file, please see [[public:nnels:etext:extract_images_from_pdf_files|Extract Images from PDF files]]

If you are dealing with a Kindle file, please see [[public:nnels:etext:extract_images_from_kindle_files_azw_azw3|Extract Images for Kindle files]]</note>

===== Use eCan Crusher to Extract images from an EPUB =====

First, we need to unzip the EPUB file to get at the images. We can easily do this using free open-source software such as [[http://www.docdataflow.com/ecancrusher/|eCanCrusher]], which works on both PC and Mac.

  - Use eCanCrusher to unzip the EPUB
     - Make sure eCanCrusher and the EPUB you want to unzip are in the same folder
     - Drag the EPUB into the eCanCrusher App
     - Wait a few minutes
     - A new folder will appear with the name of the EPUB
  - Open up the unzipped folder
  - Open the ''OEBPS'' folder (this is where all the EPUB content lives)
  - Locate the folder called ''images''
  - Insert these images into your DOCX file, as required (''Insert'' > ''Pictures'' > ''Picture from file'')

===== Mac: Use Terminal to extract images from an EPUB =====

Alternatively, if you prefer to use command line, you can use Terminal (on Mac) to extract images from an EPUB:

  - Open ''New Terminal at Folder'' 
    * Right-click on the folder that contains the EPUB file and select ''Services'' > ''New Terminal at Folder''. You may  need to [[https://lifehacker.com/launch-an-os-x-terminal-window-from-a-specific-folder-1466745514|change your Mac settings]] to create this shortcut.
  - Copy and paste the command: <code>unzip abc.epub *.jpg *.jpeg *.png *.gif</code> where abc.epub is the name of the epub file (check that there are no spaces in the filename)
  - press enter
  - you should see a new folder appear (OEBPS) that contains the extracted image files

===== PC: Change file extension to extract images from EPUB =====

  - Navigate to your EPUB file.
  - Make a copy of the file and paste it into the same folder you are in.
  - Press F2 on the copied version (to make file name editable)
  - Change the end of the file name from .epub to .zip and press enter.
  - Windows will warn you that you are changing a file extension. Tell it okay.
  - You can now access the file as you would any zip file. When you unzip the compressed file, you should see a list of items, including a folder titled "images". These will be the images you insert into your .docx.

[[public:nnels:etext:kids-books|Return to Children's Books main page]]