Wiki-Fou - User contributions [en]

Next steps

2019-04-02T17:10:15Z

Brinerustle:

* focus issues: https://chdk.fandom.com/wiki/CHDK_Manual_Focus_and_Subject_Distance_Overrides see if we can figure out how to get this to work.
* Documentation (about how to build the scanner)
* User's manual (showing how to use the scanner)
* Build a case (for transporting the scanner in a safe way)?

Possible comrades:

* Can Masdeu: https://www.canmasdeu.net/
* Virus publishing house / Virus editorial, Barcelona: http://www.viruseditorial.net/
* La Caníbal, feminist fanzines: http://lacanibal.net/
* Euraca: https://seminarioeuraca.wordpress.com/
* institutions like Fine Arts Faculty? ca2m?: http://ca2m.org/es/
** they should pay/reimbourse
** not allow them to become extractivist
** introduce the project as "we are an illegal website" and from there they'll decide
** who will decide this? this group: this does not mean that we have to bound forever
** potential consideration: getting students to scan, or volunteers, is highly problematic
* Calderu?
* Descontrol: https://descontrol.cat/
* Anarchist Bookfair of Barcelona and Sevilla: http://www.feriaanarquistasevilla.org/

Calendar:

* Have a day or two of feminist fanzines hosted by La Caníbal?

Bookscanner

2019-04-02T16:47:04Z

Brinerustle: /* Cameras */

Bookscanning in Calafou:

* We made an event called Hack the Biblio: Let's make Digital Public Libraries in 2014 as a collaboration with memoryoftheworld, when Voja Antonic donated a bookscanner to Calafou: https://calafou.org/en/content/hack-biblio-construir-bibliotecas-publicas https://calafou.org/en/content/voja-antonic-calafou
* We scan out of print books published by Virus: http://www.viruseditorial.net/
* marron_scanner 😎 was built in 2018 during the Kunlabora event for supporting other collectives that want to scan: https://calafou.org/en/content/kunlabora-ephimeral-projects-kooperative

This page is documenting the design and construction of bookscanners. For the tutorial that explains "How to use the bookscanner", go to http://wiki.calafou.org/index.php/Bookscanning

= Building a "New Standard Scanner" =

We built this: https://forum.diybookscanner.org/viewtopic.php?f=1&t=333 during the Kunlabora event in Calafou: https://calafou.org/en/content/kunlabora-ephimeral-projects-kooperative A more reproducible and portable and simple scanner.

In theory for the simple scanner it should be possible to get all the ingredients from a hardware shop ("ferreteria"). We got most of the materials from Bauhaus in Barcelona (Zona Franca). Our experience was that most of the screws, nuts and bolts are easy to substitute with others that have more or less the same dimensions.

[[File:bookscanner_pseudoready2.jpg|600px]]

== Budget ==

Kunlabora event was four days of collaborative construction. More or less six persons worked on building the scanner. This is the receipts that we spent, because we had 500 EUR budget for the raw materials from the participation fee of the event.

Receipts:

25 2x plexiglass [J] @ Expocryl, Igualada
18 2x SD cards @ Life Informatica, Barcelona
50 2x magic want camera stand @ FotoK, Barcelona
42.2 Nuts/bolts/etc. @ Bauhaus, Zona Franca, Barcelona
108.8 Nuts/bolts/etc. @ Bauhaus, Zona Franca, Barcelona
10 2x USB cable male/female @ Worten San Antoni, Barcelona
5 2x mini USB (USB-B) cable @ Tienda Cables, Barcelona
178 2x Canon IXUS 175 compact digital camera @ Amazon.es
60 4x Wooden beams (listones) @ Fustes Fargas, Barcelona
============================================
497

Donations:

70 Raspberry Pi 3 (Model B), 2x SD cards, 5V charger, rulers [M] @ Barcelona

We also used nuts and bolts, etc. found in the workshop of Calafou (in Catalunya, near Barcelona). The conclusion is that it should be possible to build this scanner from about 5-600 EUR anywhere in (Western) Europe. We did not use all the materials we bought and if we would do it again then we tried to use real wood instead of FDM, because the latter proved very fragile. However, this could make the platen more heavy, and it is already quite heavy.

== Parts / componentes ==

[[File:01 SHOPPING 001.JPG|500px|none|left]]
Going for shopping
[[File:01 SHOPPING 003.JPG|500px|none|left]]

From Bauhaus, Barcelona (Zona Franca):

[[File:01 SHOPPING 027.JPG|500px|none|left]]
-1x Varilla roscada
-4x Listones de madera ~800x40x90mm
-2x (Tablero) MD sheet 600x400x10mm
-2x (Tablero) MDF sheet 600x400x16mm
[[File:01 SHOPPING 023.JPG|500px|none|left]]
- Cola blanca rápida para madera
[[File:01 SHOPPING 024.JPG|500px|none|left]]
- Base 4 tomas 1.5 mts
[[File:01 SHOPPING 007.JPG|500px|none|left]]
- Tuerca hexagonal
[[File:01 SHOPPING 020.JPG|500px|none|left]]
- Guia corredera
[[File:01 SHOPPING 004.JPG|500px|none|left]]
- Arandelas ancha
[[File:01 SHOPPING 005.JPG|500px|none|left]]
- Aldabon BPF 185 M
[[File:01 SHOPPING 006.JPG|500px|none|left]]
- Tornillo mad.cab.pl.
[[File:01 SHOPPING 010.JPG|500px|none|left]]
- Tornillo cab. avell.
[[File:01 SHOPPING 011.JPG|500px|none|left]]
- Tornillo p/metal
[[File:01 SHOPPING 008.JPG|500px|none|left]]
- Tuerca palomilla
[[File:01 SHOPPING 021.JPG|500px|none|left]]
- Guia cajones 10kg
[[File:01 SHOPPING 022.JPG|500px|none|left]]
- Spax cab. red zinc
[[File:01 SHOPPING 012.JPG|500px|none|left]]
- Tirador dorado
[[File:01 SHOPPING 014.JPG|500px|none|left]]
- 4x Abrazaderas
[[File:01 SHOPPING 025.JPG|500px|none|left]]
- Mosqueton-fw

- 2 x plexi glass 380x280x3mm from a company in Igualada that J. found.

Other things from other shops:

[[File:01 SHOPPING 013.JPG|500px|none|left]]
- 4x Cable USB 2.0 male-female @ Worten Sant Antoni
- 2x USB-A -> USB-B (mini) cables @ Tienda de Cables
- 2x SD Cards 16 Gg
[[File:01 SHOPPING 017.JPG|500px|none|left]]
- 2x Manfrotto brazo flexible MF237 (Nr. referencia AFP018036) @ FotoK, Ronda Universitat
[[File:01 SHOPPING 015.JPG|500px|none|left]]
- 2x Tira LED 1 nice

- 2 x digital cameras (see below for background information): Canon IXUS 175 (Powershot / ELPH 180)
- https://www.amazon.es/Canon-IXUS-175-compacta-estabilizador/dp/B01A8QU70I/
- http://chdk.wikia.com/wiki/ELPH180
- https://www.canon-europe.com/for_home/product_finder/cameras/digital_camera/ixus/ixus_175/specification.aspx

For electronic parts a good shop in Barcelona is Diotronic: https://diotronic.com/

- usb charger to give power to the external trigger trough USB cable

Things to take in consideration from the building experience

* the MDF pieces are fragile and gave us problems when introducing screws
* we considered varnishing the wood pieces to limit humidity impact
* the plexiglas we bought generates many reflections
* passing from inches to cm was uncomfortable
* the position and height of the light should be tested before being fixed
* the upper part of the light stand should be easier to mount and unmount for transportation
* the wood used for the platen should be without texture or painted with mate dark paint
* the gooseneck (Manfrotto) option for the camera stand is not a good option: it is very easy to put the camera in the way of the cradle; the calibration process is difficult because the cameras can move in the three axis; they are springy and difficult to set in an exact position

== Cameras ==

The bookscanner is basically a glorified camera stand that allows us to take good pictures of book pages. So the cameras are an important part of the bookscanner. Summary of research about cameras for book scanners:

Basically there are three categories of cameras that can be used for book scanners (from cheapest to most expensive).

1. Remote control support

The cheapest option is any camera with remote trigger support, so we can take pictures without pushing the button on the camera. This is important because when you press the button the camera position may be disadjusted to the physical pressure.

2. CHDK firmware

Middle category is CHDK firmware compatibles. CHDK is a third party open source firmware that allows the customisation of cameras. CHDK firmware is for Canon Powershot cameras, which are the cheaper compact digital camera product line. We had 200 euros in the budget for cameras, so we went with this option.

3. Magic Lantern support

Magic Lantern is a third party open source firmware that is more advanced. However, it only works with Canon DLSR cameras (these are the cameras that have a reflex mirror to look at the shot through a small hole before you take the picture, and they usually have big lenses). The scanner we have now uses Canon 1100D, which are the cheapest type suported by Magic Lantern, but they still cost a few hundred euros.

4. Connecting to a monitor

It is very useful to be able to connect the cameras to a monitor during the calibration process. The cameras we bought use the same output for connecting to a remote control and to a monitor making it not practical at all using a monitor. Furthermore, connection with usb to a computer monitor was not an option, we had to look for RC connectors or adapters.

5. A note about webcams:

An option might seem to use two high resolution webcams directly connected to a laptop to trigger taking pictures and monitor their quality, and there are full HD webcams (~2 Megapixels). The problem with all webcams, however, is that they have a fixed optical zoom, at quite a wide angle. To get those pixels covering the book page, you need to be very close to the book (~25cm). This forces you to use a design similar to what Reece Arnott uses, or the Ion Audio Booksaver. These designs make it impossible to avoid glare from light sources, no matter where the lights are placed. To avoid glare, you need a narrow zoom and a good distance (~90 cm) between book and camera.

== Building process ==

=== Base / Base ===

[[File:02 BASE 035.JPG|500px|none|left]]
[[File:02 BASE 043.JPG|500px|none|left]]
[[File:02 BASE 040.JPG|500px|none|left]]
We cut the wood beams to have 2 pieces of 56x4cm and 2 of 31.5x4cm

[[File:02 BASE 044.JPG|500px|none|left]]
[[File:02 BASE 041.JPG|500px|none|left]]
we measured with precision tools and marked the position of the drawer sliders on the 54x4cm wood beams

[[File:02 BASE 045.JPG|500px|none|left]]
we drilled holes on the marked position

[[File:02 BASE 049.JPG|500px|none|left]]
[[File:02 BASE 050.JPG|500px|none|left]]
[[File:02 BASE 051.JPG|500px|none|left]]
and then we fixed the sliders

[[File:02 BASE 033.JPG|500px|none|left]]
We used the thicker MDF material to cut a 37x29cm sheet

[[File:02 BASE 056.JPG|500px|none|left]]
The last parts were fixing the other part of the sliders to the MDF sheet and attaching the different part of the base with screws

=== Cradle / Cuna ===
The cradle is a V-shaped book holder partly fixed to the base
[[File:07 GEN 036.JPG|500px|none|left]]
We cut two MDF (thin) sheets for the book holder

[[File:03 CRADDLE 037.JPG|500px|none|left]]
[[File:03 CRADDLE 046.JPG|500px|none|left]]
And 4 small triangles to maintain the book holder on the base with a 90 degree angle between both sheets
[[File:03 CRADDLE 057.JPG|500px|none|left]]
We measured were to position the triangles
[[File:03 CRADDLE 071.JPG|500px|none|left]]
Drilled the MDF sheet on the base
[[File:03 CRADDLE 058.JPG|500px|none|left]]
And fixed the MDF small triangles

[[File:03 CRADDLE 059.JPG|500px|none|left]]
We drilled the MDF sheet of the Craddle
[[File:03 CRADDLE 061.JPG|500px|none|left]]
And fixed it to the triangles

NOT DOCUMENTED WITH PICTURES
[[File:05 COLUMN 066.JPG|500px|none|left]]
The 2 other triangles were fixed to the other MDF sheet without being fixed to the base.
The distance between the triangles is of 19.5cm.
We cut a 19.5x19.5cm MDF square that we attached to the other side of the base.
The drilled the 2 triangles in order to introduce a threaded rod.
The threaded rod is used to tighten the triangles against the square fixed on the base.

=== Platen / Platina ===

[[File:04 PLATEN 039.JPG|500px|none|left]]
[[File:04 PLATEN 047.JPG|500px|none|left]]

[[File:04 PLATEN 053.JPG|500px|none|left]]
[[File:04 PLATEN 054.JPG|500px|none|left]]
[[File:04 PLATEN 055.JPG|500px|none|left]]

[[File:04 PLATEN 063.JPG|500px|none|left]]

=== Column / Columna ===

[[File:05 COLUMN 065.JPG|500px|none|left]]
[[File:05 COLUMN 066.JPG|500px|none|left]]
[[File:05 COLUMN 067.JPG|500px|none|left]]
[[File:05 COLUMN 068.JPG|500px|none|left]]

[[File:05 COLUMN 070.JPG|500px|none|left]]
[[File:05 COLUMN 072.JPG|500px|none|left]]
[[File:05 COLUMN 073.JPG|500px|none|left]]
[[File:05 COLUMN 074.JPG|500px|none|left]]
[[File:05 COLUMN 075.JPG|500px|none|left]]
[[File:05 COLUMN 076.JPG|500px|none|left]]
[[File:05 COLUMN 077.JPG|500px|none|left]]
[[File:05 COLUMN 078.JPG|500px|none|left]]
[[File:05 COLUMN 079.JPG|500px|none|left]]
[[File:05 COLUMN 080.JPG|500px|none|left]]
[[File:05 COLUMN 083.JPG|500px|none|left]]
[[File:05 COLUMN 084.JPG|500px|none|left]]

[[File:06 MOUNTED 086.JPG|500px|none|left]]

=== CHDK ===

=== External trigger ===

[[File:08 TRIGERING 081.JPG|500px|none|left]]
[[File:08 TRIGERING 082.JPG|500px|none|left]]

= Photos =

== Mounting ==

<gallery>
File:06_MOUNTED_064.JPG
File:06_MOUNTED_086.JPG
File:06_MOUNTED_088.JPG
File:06_MOUNTED_089.JPG
</gallery>

== Miscellaneous ==

<gallery>
File:07_GEN_031.JPG
File:07_GEN_034.JPG
File:07_GEN_036.JPG
File:07_GEN_052.JPG
File:07_GEN_085.JPG
</gallery>

== Triggering mechanism ==

<gallery>
File:08_TRIGERING_069.JPG
File:08_TRIGERING_081.JPG
File:08_TRIGERING_082.JPG
</gallery>

== Camera holder ==

<gallery>
File:09_CAM-HOLDERS_087.JPG
File:09_CAM-HOLDERS_090.JPG
</gallery>

== Day 1 (temporary) ==

<gallery>
File:IMG_20181012_161540990.jpg
File:IMG_20181012_161552147.jpg
File:IMG_20181012_161615376.jpg
File:IMG_20181012_161626209.jpg
File:IMG_20181012_161639871.jpg
File:IMG_20181012_162253725.jpg
</gallery>

= Raspberry Pi for the bookscanner =

At the moment we use an electromechanical button documented on the CHDK website that works well but does not do much more than triggering the two cameras to shoot at the same time: http://chdk.wikia.com/wiki/USB_Remote

There are many more possibilities of how to optimise the bookscanning process. Many ideas start with connecting the cameras to a small computer such as the Raspberry Pi. We made some experiments and tests with this setup, which is documented below:

It runs [https://www.raspbian.org/ Raspbian].

== CHDKPTP ==

In /home/pi/chdkptp there are precompiled binaries of [https://app.assembla.com/spaces/chdkptp/wiki CHDKPTP] downloaded from [https://app.assembla.com/spaces/chdkptp/documents here].

CHDKPTP is used for remote control of camera running CHDK firmware.

Our setup has two modes of work:
* mechanical "button" which triggers both camera capturing its photo based on this tutorial: http://chdk.wikia.com/wiki/USB_Remote
* (in progress) Raspberry Pi mode where an bookscanner operator uses Raspberry Pi to capture photos, preview photos in real time and transfer them already renamed for the next step in Scantailor.

When camera is connected this line will list info about the camera e.g.:
<nowiki>sudo ./chdkptp.sh -elist</nowiki>
and for one of the camera this is what is listed then:
<nowiki>-1:Canon IXUS 175 b=001 d=030 v=0x4a9 p=0x32c1 s=8B20D62641B041BAA3E1D597D560D110</nowiki>

An example of capturing a picture from commandline (once in /home/pi/chdkptp/):
<nowiki>sudo ./chdkptp.sh -e"connect -d=030" -erec -eshoot</nowiki>
Above line connects to the camera sitting on -d=021, puts it into rec mode (if not already) and capture the photo saving it to SD card already in camera. If one wants to bypass the SD card altogether it should replace -eshoot with -eremoteshoot. In that case ./chdkptp.sh will save photos into the directory from where it was called.

Note: check the SD card is locked.

== ZeroTier ==

It is added to 565799d8f6ebf1a8 public network of [https://zerotier.com ZeroTier] with this command:
<nowiki>sudo zerotier-cli join 565799d8f6ebf1a8</nowiki>
and it got static IP address (in 565799d8f6ebf1a8 network):
<nowiki>192.168.192.171/24</nowiki>

In /home/pi/.ssh/authorized_keys public keys of maxigas and marcell are added.

= Ideas for building Voja's scanner =

Our first idea was to reproduce Voja's scanner but we had to realise that we are not Voja and the scanner is very beautiful and unique engineering and consequently it is hard to reproduce.

Here are two links to the public documentation of our scanner, built by Voja Antonic:

https://www.memoryoftheworld.org/blog/2012/10/28/our-beloved-bookscanner-2/

https://hackaday.io/project/5604-diy-book-scanner

The electronics is not really documented (which means that it is hard to reproduce) and it is built from basic parts (which means that it takes a lot of time to put it together). So we brainstorm about an Arduino-based solution instead. Arduino is a general-purpose programmable microcontroller that has already built-in many of the functions/parts we need. The idea is that this makes it easier for us to build the scanner and for others to reproduce it. We also have more experience working with Arduino than with only basic electronic components.

We will also try to use cheaper cameras in order to bring down the budget.

= Biblio-graphy =

== About our first bookscanner ==

[https://www.memoryoftheworld.org/blog/2012/10/28/our-beloved-bookscanner/ English]

[https://www.memoryoftheworld.org/es/blog/2012/10/28/our-beloved-bookscanner/ Spanish]

== Principal sources ==

[http://en.flossmanuals.net/e-book-enlightenment/ Reading And Leading With One Laptop Per Child]

== Future activities ==

[[next steps]]

Bookscanner

2019-04-02T15:56:01Z

Brinerustle: /* Cameras */

Bookscanning in Calafou:

* We made an event called Hack the Biblio: Let's make Digital Public Libraries in 2014 as a collaboration with memoryoftheworld, when Voja Antonic donated a bookscanner to Calafou: https://calafou.org/en/content/hack-biblio-construir-bibliotecas-publicas https://calafou.org/en/content/voja-antonic-calafou
* We scan out of print books published by Virus: http://www.viruseditorial.net/
* marron_scanner 😎 was built in 2018 during the Kunlabora event for supporting other collectives that want to scan: https://calafou.org/en/content/kunlabora-ephimeral-projects-kooperative

This page is documenting the design and construction of bookscanners. For the tutorial that explains "How to use the bookscanner", go to http://wiki.calafou.org/index.php/Bookscanning

= Building a "New Standard Scanner" =

We built this: https://forum.diybookscanner.org/viewtopic.php?f=1&t=333 during the Kunlabora event in Calafou: https://calafou.org/en/content/kunlabora-ephimeral-projects-kooperative A more reproducible and portable and simple scanner.

In theory for the simple scanner it should be possible to get all the ingredients from a hardware shop ("ferreteria"). We got most of the materials from Bauhaus in Barcelona (Zona Franca). Our experience was that most of the screws, nuts and bolts are easy to substitute with others that have more or less the same dimensions.

[[File:bookscanner_pseudoready2.jpg|600px]]

== Budget ==

Kunlabora event was four days of collaborative construction. More or less six persons worked on building the scanner. This is the receipts that we spent, because we had 500 EUR budget for the raw materials from the participation fee of the event.

Receipts:

25 2x plexiglass [J] @ Expocryl, Igualada
18 2x SD cards @ Life Informatica, Barcelona
50 2x magic want camera stand @ FotoK, Barcelona
42.2 Nuts/bolts/etc. @ Bauhaus, Zona Franca, Barcelona
108.8 Nuts/bolts/etc. @ Bauhaus, Zona Franca, Barcelona
10 2x USB cable male/female @ Worten San Antoni, Barcelona
5 2x mini USB (USB-B) cable @ Tienda Cables, Barcelona
178 2x Canon IXUS 175 compact digital camera @ Amazon.es
60 4x Wooden beams (listones) @ Fustes Fargas, Barcelona
============================================
497

Donations:

70 Raspberry Pi 3 (Model B), 2x SD cards, 5V charger, rulers [M] @ Barcelona

We also used nuts and bolts, etc. found in the workshop of Calafou (in Catalunya, near Barcelona). The conclusion is that it should be possible to build this scanner from about 5-600 EUR anywhere in (Western) Europe. We did not use all the materials we bought and if we would do it again then we tried to use real wood instead of FDM, because the latter proved very fragile. However, this could make the platen more heavy, and it is already quite heavy.

== Parts / componentes ==

[[File:01 SHOPPING 001.JPG|500px|none|left]]
Going for shopping
[[File:01 SHOPPING 003.JPG|500px|none|left]]

From Bauhaus, Barcelona (Zona Franca):

[[File:01 SHOPPING 027.JPG|500px|none|left]]
-1x Varilla roscada
-4x Listones de madera ~800x40x90mm
-2x (Tablero) MD sheet 600x400x10mm
-2x (Tablero) MDF sheet 600x400x16mm
[[File:01 SHOPPING 023.JPG|500px|none|left]]
- Cola blanca rápida para madera
[[File:01 SHOPPING 024.JPG|500px|none|left]]
- Base 4 tomas 1.5 mts
[[File:01 SHOPPING 007.JPG|500px|none|left]]
- Tuerca hexagonal
[[File:01 SHOPPING 020.JPG|500px|none|left]]
- Guia corredera
[[File:01 SHOPPING 004.JPG|500px|none|left]]
- Arandelas ancha
[[File:01 SHOPPING 005.JPG|500px|none|left]]
- Aldabon BPF 185 M
[[File:01 SHOPPING 006.JPG|500px|none|left]]
- Tornillo mad.cab.pl.
[[File:01 SHOPPING 010.JPG|500px|none|left]]
- Tornillo cab. avell.
[[File:01 SHOPPING 011.JPG|500px|none|left]]
- Tornillo p/metal
[[File:01 SHOPPING 008.JPG|500px|none|left]]
- Tuerca palomilla
[[File:01 SHOPPING 021.JPG|500px|none|left]]
- Guia cajones 10kg
[[File:01 SHOPPING 022.JPG|500px|none|left]]
- Spax cab. red zinc
[[File:01 SHOPPING 012.JPG|500px|none|left]]
- Tirador dorado
[[File:01 SHOPPING 014.JPG|500px|none|left]]
- 4x Abrazaderas
[[File:01 SHOPPING 025.JPG|500px|none|left]]
- Mosqueton-fw

- 2 x plexi glass 380x280x3mm from a company in Igualada that J. found.

Other things from other shops:

[[File:01 SHOPPING 013.JPG|500px|none|left]]
- 4x Cable USB 2.0 male-female @ Worten Sant Antoni
- 2x USB-A -> USB-B (mini) cables @ Tienda de Cables
- 2x SD Cards 16 Gg
[[File:01 SHOPPING 017.JPG|500px|none|left]]
- 2x Manfrotto brazo flexible MF237 (Nr. referencia AFP018036) @ FotoK, Ronda Universitat
[[File:01 SHOPPING 015.JPG|500px|none|left]]
- 2x Tira LED 1 nice

- 2 x digital cameras (see below for background information): Canon IXUS 175 (Powershot / ELPH 180)
- https://www.amazon.es/Canon-IXUS-175-compacta-estabilizador/dp/B01A8QU70I/
- http://chdk.wikia.com/wiki/ELPH180
- https://www.canon-europe.com/for_home/product_finder/cameras/digital_camera/ixus/ixus_175/specification.aspx

For electronic parts a good shop in Barcelona is Diotronic: https://diotronic.com/

- usb charger to give power to the external trigger trough USB cable

Things to take in consideration from the building experience

* the MDF pieces are fragile and gave us problems when introducing screws
* we considered varnishing the wood pieces to limit humidity impact
* the plexiglas we bought generates many reflections
* passing from inches to cm was uncomfortable
* the position and height of the light should be tested before being fixed
* the upper part of the light stand should be easier to mount and unmount for transportation
* the wood used for the platen should be without texture or painted with mate dark paint
* the gooseneck (Manfrotto) option for the camera stand is not a good option: it is very easy to put the camera in the way of the cradle; the calibration process is difficult because the cameras can move in the three axis; they are springy and difficult to set in an exact position

== Cameras ==

The bookscanner is basically a glorified camera stand that allows us to take good pictures of book pages. So the cameras are an important part of the bookscanner. Summary of research about cameras for book scanners:

Basically there are three categories of cameras that can be used for book scanners (from cheapest to most expensive).

1. Remote control support

The cheapest option is any camera with remote trigger support, so we can take pictures without pushing the button on the camera. This is important because when you press the button the camera position may be disadjusted to the physical pressure.

2. CHDK firmware

Middle category is CHDK firmware compatibles. CHDK is a third party open source firmware that allows the customisation of cameras. CHDK firmware is for Canon Powershot cameras, which are the cheaper compact digital camera product line. We had 200 euros in the budget for cameras, so we went with this option.

3. Magic Lantern support

Magic Lantern is a third party open source firmware that is more advanced. However, it only works with Canon DLSR cameras (these are the cameras that have a reflex mirror to look at the shot through a small hole before you take the picture, and they usually have big lenses). The scanner we have now uses Canon 1100D, which are the cheapest type suported by Magic Lantern, but they still cost a few hundred euros.

4. Connecting to a monitor

It is very useful to be able to connect the cameras to a monitor during the calibration process. The cameras we bought use the same output for connecting to a remote control and to a monitor making it not practical at all using a monitor. Furthermore, connection with usb to a computer monitor was not an option, we had to look for RC connectors or adapters.

5. Webcams

Another option could be to use two high resolution webcams directly connected to a laptop to trigger taking pictures and monitor their quality, but the problem with webcams is they almost always have a wide field of view over 90 degrees, making such a solution impossible, or requiring that the cameras would be so close to the page as to distort the lines on the page or interfere with the other camera.

== Building process ==

=== Base / Base ===

[[File:02 BASE 035.JPG|500px|none|left]]
[[File:02 BASE 043.JPG|500px|none|left]]
[[File:02 BASE 040.JPG|500px|none|left]]
We cut the wood beams to have 2 pieces of 56x4cm and 2 of 31.5x4cm

[[File:02 BASE 044.JPG|500px|none|left]]
[[File:02 BASE 041.JPG|500px|none|left]]
we measured with precision tools and marked the position of the drawer sliders on the 54x4cm wood beams

[[File:02 BASE 045.JPG|500px|none|left]]
we drilled holes on the marked position

[[File:02 BASE 049.JPG|500px|none|left]]
[[File:02 BASE 050.JPG|500px|none|left]]
[[File:02 BASE 051.JPG|500px|none|left]]
and then we fixed the sliders

[[File:02 BASE 033.JPG|500px|none|left]]
We used the thicker MDF material to cut a 37x29cm sheet

[[File:02 BASE 056.JPG|500px|none|left]]
The last parts were fixing the other part of the sliders to the MDF sheet and attaching the different part of the base with screws

=== Cradle / Cuna ===
The cradle is a V-shaped book holder partly fixed to the base
[[File:07 GEN 036.JPG|500px|none|left]]
We cut two MDF (thin) sheets for the book holder

[[File:03 CRADDLE 037.JPG|500px|none|left]]
[[File:03 CRADDLE 046.JPG|500px|none|left]]
And 4 small triangles to maintain the book holder on the base with a 90 degree angle between both sheets
[[File:03 CRADDLE 057.JPG|500px|none|left]]
We measured were to position the triangles
[[File:03 CRADDLE 071.JPG|500px|none|left]]
Drilled the MDF sheet on the base
[[File:03 CRADDLE 058.JPG|500px|none|left]]
And fixed the MDF small triangles

[[File:03 CRADDLE 059.JPG|500px|none|left]]
We drilled the MDF sheet of the Craddle
[[File:03 CRADDLE 061.JPG|500px|none|left]]
And fixed it to the triangles

NOT DOCUMENTED WITH PICTURES
[[File:05 COLUMN 066.JPG|500px|none|left]]
The 2 other triangles were fixed to the other MDF sheet without being fixed to the base.
The distance between the triangles is of 19.5cm.
We cut a 19.5x19.5cm MDF square that we attached to the other side of the base.
The drilled the 2 triangles in order to introduce a threaded rod.
The threaded rod is used to tighten the triangles against the square fixed on the base.

=== Platen / Platina ===

[[File:04 PLATEN 039.JPG|500px|none|left]]
[[File:04 PLATEN 047.JPG|500px|none|left]]

[[File:04 PLATEN 053.JPG|500px|none|left]]
[[File:04 PLATEN 054.JPG|500px|none|left]]
[[File:04 PLATEN 055.JPG|500px|none|left]]

[[File:04 PLATEN 063.JPG|500px|none|left]]

=== Column / Columna ===

[[File:05 COLUMN 065.JPG|500px|none|left]]
[[File:05 COLUMN 066.JPG|500px|none|left]]
[[File:05 COLUMN 067.JPG|500px|none|left]]
[[File:05 COLUMN 068.JPG|500px|none|left]]

[[File:05 COLUMN 070.JPG|500px|none|left]]
[[File:05 COLUMN 072.JPG|500px|none|left]]
[[File:05 COLUMN 073.JPG|500px|none|left]]
[[File:05 COLUMN 074.JPG|500px|none|left]]
[[File:05 COLUMN 075.JPG|500px|none|left]]
[[File:05 COLUMN 076.JPG|500px|none|left]]
[[File:05 COLUMN 077.JPG|500px|none|left]]
[[File:05 COLUMN 078.JPG|500px|none|left]]
[[File:05 COLUMN 079.JPG|500px|none|left]]
[[File:05 COLUMN 080.JPG|500px|none|left]]
[[File:05 COLUMN 083.JPG|500px|none|left]]
[[File:05 COLUMN 084.JPG|500px|none|left]]

[[File:06 MOUNTED 086.JPG|500px|none|left]]

=== CHDK ===

=== External trigger ===

[[File:08 TRIGERING 081.JPG|500px|none|left]]
[[File:08 TRIGERING 082.JPG|500px|none|left]]

= Photos =

== Mounting ==

<gallery>
File:06_MOUNTED_064.JPG
File:06_MOUNTED_086.JPG
File:06_MOUNTED_088.JPG
File:06_MOUNTED_089.JPG
</gallery>

== Miscellaneous ==

<gallery>
File:07_GEN_031.JPG
File:07_GEN_034.JPG
File:07_GEN_036.JPG
File:07_GEN_052.JPG
File:07_GEN_085.JPG
</gallery>

== Triggering mechanism ==

<gallery>
File:08_TRIGERING_069.JPG
File:08_TRIGERING_081.JPG
File:08_TRIGERING_082.JPG
</gallery>

== Camera holder ==

<gallery>
File:09_CAM-HOLDERS_087.JPG
File:09_CAM-HOLDERS_090.JPG
</gallery>

== Day 1 (temporary) ==

<gallery>
File:IMG_20181012_161540990.jpg
File:IMG_20181012_161552147.jpg
File:IMG_20181012_161615376.jpg
File:IMG_20181012_161626209.jpg
File:IMG_20181012_161639871.jpg
File:IMG_20181012_162253725.jpg
</gallery>

= Raspberry Pi for the bookscanner =

At the moment we use an electromechanical button documented on the CHDK website that works well but does not do much more than triggering the two cameras to shoot at the same time: http://chdk.wikia.com/wiki/USB_Remote

There are many more possibilities of how to optimise the bookscanning process. Many ideas start with connecting the cameras to a small computer such as the Raspberry Pi. We made some experiments and tests with this setup, which is documented below:

It runs [https://www.raspbian.org/ Raspbian].

== CHDKPTP ==

In /home/pi/chdkptp there are precompiled binaries of [https://app.assembla.com/spaces/chdkptp/wiki CHDKPTP] downloaded from [https://app.assembla.com/spaces/chdkptp/documents here].

CHDKPTP is used for remote control of camera running CHDK firmware.

Our setup has two modes of work:
* mechanical "button" which triggers both camera capturing its photo based on this tutorial: http://chdk.wikia.com/wiki/USB_Remote
* (in progress) Raspberry Pi mode where an bookscanner operator uses Raspberry Pi to capture photos, preview photos in real time and transfer them already renamed for the next step in Scantailor.

When camera is connected this line will list info about the camera e.g.:
<nowiki>sudo ./chdkptp.sh -elist</nowiki>
and for one of the camera this is what is listed then:
<nowiki>-1:Canon IXUS 175 b=001 d=030 v=0x4a9 p=0x32c1 s=8B20D62641B041BAA3E1D597D560D110</nowiki>

An example of capturing a picture from commandline (once in /home/pi/chdkptp/):
<nowiki>sudo ./chdkptp.sh -e"connect -d=030" -erec -eshoot</nowiki>
Above line connects to the camera sitting on -d=021, puts it into rec mode (if not already) and capture the photo saving it to SD card already in camera. If one wants to bypass the SD card altogether it should replace -eshoot with -eremoteshoot. In that case ./chdkptp.sh will save photos into the directory from where it was called.

Note: check the SD card is locked.

== ZeroTier ==

It is added to 565799d8f6ebf1a8 public network of [https://zerotier.com ZeroTier] with this command:
<nowiki>sudo zerotier-cli join 565799d8f6ebf1a8</nowiki>
and it got static IP address (in 565799d8f6ebf1a8 network):
<nowiki>192.168.192.171/24</nowiki>

In /home/pi/.ssh/authorized_keys public keys of maxigas and marcell are added.

= Ideas for building Voja's scanner =

Our first idea was to reproduce Voja's scanner but we had to realise that we are not Voja and the scanner is very beautiful and unique engineering and consequently it is hard to reproduce.

Here are two links to the public documentation of our scanner, built by Voja Antonic:

https://www.memoryoftheworld.org/blog/2012/10/28/our-beloved-bookscanner-2/

https://hackaday.io/project/5604-diy-book-scanner

The electronics is not really documented (which means that it is hard to reproduce) and it is built from basic parts (which means that it takes a lot of time to put it together). So we brainstorm about an Arduino-based solution instead. Arduino is a general-purpose programmable microcontroller that has already built-in many of the functions/parts we need. The idea is that this makes it easier for us to build the scanner and for others to reproduce it. We also have more experience working with Arduino than with only basic electronic components.

We will also try to use cheaper cameras in order to bring down the budget.

= Biblio-graphy =

== About our first bookscanner ==

[https://www.memoryoftheworld.org/blog/2012/10/28/our-beloved-bookscanner/ English]

[https://www.memoryoftheworld.org/es/blog/2012/10/28/our-beloved-bookscanner/ Spanish]

== Principal sources ==

[http://en.flossmanuals.net/e-book-enlightenment/ Reading And Leading With One Laptop Per Child]

== Future activities ==

[[next steps]]

Bookscanner

2019-04-02T15:47:43Z

Brinerustle: /* Cameras */

Bookscanning in Calafou:

* We made an event called Hack the Biblio: Let's make Digital Public Libraries in 2014 as a collaboration with memoryoftheworld, when Voja Antonic donated a bookscanner to Calafou: https://calafou.org/en/content/hack-biblio-construir-bibliotecas-publicas https://calafou.org/en/content/voja-antonic-calafou
* We scan out of print books published by Virus: http://www.viruseditorial.net/
* marron_scanner 😎 was built in 2018 during the Kunlabora event for supporting other collectives that want to scan: https://calafou.org/en/content/kunlabora-ephimeral-projects-kooperative

This page is documenting the design and construction of bookscanners. For the tutorial that explains "How to use the bookscanner", go to http://wiki.calafou.org/index.php/Bookscanning

= Building a "New Standard Scanner" =

We built this: https://forum.diybookscanner.org/viewtopic.php?f=1&t=333 during the Kunlabora event in Calafou: https://calafou.org/en/content/kunlabora-ephimeral-projects-kooperative A more reproducible and portable and simple scanner.

In theory for the simple scanner it should be possible to get all the ingredients from a hardware shop ("ferreteria"). We got most of the materials from Bauhaus in Barcelona (Zona Franca). Our experience was that most of the screws, nuts and bolts are easy to substitute with others that have more or less the same dimensions.

[[File:bookscanner_pseudoready2.jpg|600px]]

== Budget ==

Kunlabora event was four days of collaborative construction. More or less six persons worked on building the scanner. This is the receipts that we spent, because we had 500 EUR budget for the raw materials from the participation fee of the event.

Receipts:

25 2x plexiglass [J] @ Expocryl, Igualada
18 2x SD cards @ Life Informatica, Barcelona
50 2x magic want camera stand @ FotoK, Barcelona
42.2 Nuts/bolts/etc. @ Bauhaus, Zona Franca, Barcelona
108.8 Nuts/bolts/etc. @ Bauhaus, Zona Franca, Barcelona
10 2x USB cable male/female @ Worten San Antoni, Barcelona
5 2x mini USB (USB-B) cable @ Tienda Cables, Barcelona
178 2x Canon IXUS 175 compact digital camera @ Amazon.es
60 4x Wooden beams (listones) @ Fustes Fargas, Barcelona
============================================
497

Donations:

70 Raspberry Pi 3 (Model B), 2x SD cards, 5V charger, rulers [M] @ Barcelona

We also used nuts and bolts, etc. found in the workshop of Calafou (in Catalunya, near Barcelona). The conclusion is that it should be possible to build this scanner from about 5-600 EUR anywhere in (Western) Europe. We did not use all the materials we bought and if we would do it again then we tried to use real wood instead of FDM, because the latter proved very fragile. However, this could make the platen more heavy, and it is already quite heavy.

== Parts / componentes ==

[[File:01 SHOPPING 001.JPG|500px|none|left]]
Going for shopping
[[File:01 SHOPPING 003.JPG|500px|none|left]]

From Bauhaus, Barcelona (Zona Franca):

[[File:01 SHOPPING 027.JPG|500px|none|left]]
-1x Varilla roscada
-4x Listones de madera ~800x40x90mm
-2x (Tablero) MD sheet 600x400x10mm
-2x (Tablero) MDF sheet 600x400x16mm
[[File:01 SHOPPING 023.JPG|500px|none|left]]
- Cola blanca rápida para madera
[[File:01 SHOPPING 024.JPG|500px|none|left]]
- Base 4 tomas 1.5 mts
[[File:01 SHOPPING 007.JPG|500px|none|left]]
- Tuerca hexagonal
[[File:01 SHOPPING 020.JPG|500px|none|left]]
- Guia corredera
[[File:01 SHOPPING 004.JPG|500px|none|left]]
- Arandelas ancha
[[File:01 SHOPPING 005.JPG|500px|none|left]]
- Aldabon BPF 185 M
[[File:01 SHOPPING 006.JPG|500px|none|left]]
- Tornillo mad.cab.pl.
[[File:01 SHOPPING 010.JPG|500px|none|left]]
- Tornillo cab. avell.
[[File:01 SHOPPING 011.JPG|500px|none|left]]
- Tornillo p/metal
[[File:01 SHOPPING 008.JPG|500px|none|left]]
- Tuerca palomilla
[[File:01 SHOPPING 021.JPG|500px|none|left]]
- Guia cajones 10kg
[[File:01 SHOPPING 022.JPG|500px|none|left]]
- Spax cab. red zinc
[[File:01 SHOPPING 012.JPG|500px|none|left]]
- Tirador dorado
[[File:01 SHOPPING 014.JPG|500px|none|left]]
- 4x Abrazaderas
[[File:01 SHOPPING 025.JPG|500px|none|left]]
- Mosqueton-fw

- 2 x plexi glass 380x280x3mm from a company in Igualada that J. found.

Other things from other shops:

[[File:01 SHOPPING 013.JPG|500px|none|left]]
- 4x Cable USB 2.0 male-female @ Worten Sant Antoni
- 2x USB-A -> USB-B (mini) cables @ Tienda de Cables
- 2x SD Cards 16 Gg
[[File:01 SHOPPING 017.JPG|500px|none|left]]
- 2x Manfrotto brazo flexible MF237 (Nr. referencia AFP018036) @ FotoK, Ronda Universitat
[[File:01 SHOPPING 015.JPG|500px|none|left]]
- 2x Tira LED 1 nice

- 2 x digital cameras (see below for background information): Canon IXUS 175 (Powershot / ELPH 180)
- https://www.amazon.es/Canon-IXUS-175-compacta-estabilizador/dp/B01A8QU70I/
- http://chdk.wikia.com/wiki/ELPH180
- https://www.canon-europe.com/for_home/product_finder/cameras/digital_camera/ixus/ixus_175/specification.aspx

For electronic parts a good shop in Barcelona is Diotronic: https://diotronic.com/

- usb charger to give power to the external trigger trough USB cable

Things to take in consideration from the building experience

* the MDF pieces are fragile and gave us problems when introducing screws
* we considered varnishing the wood pieces to limit humidity impact
* the plexiglas we bought generates many reflections
* passing from inches to cm was uncomfortable
* the position and height of the light should be tested before being fixed
* the upper part of the light stand should be easier to mount and unmount for transportation
* the wood used for the platen should be without texture or painted with mate dark paint
* the gooseneck (Manfrotto) option for the camera stand is not a good option: it is very easy to put the camera in the way of the cradle; the calibration process is difficult because the cameras can move in the three axis; they are springy and difficult to set in an exact position

== Cameras ==

The bookscanner is basically a glorified camera stand that allows us to take good pictures of book pages. So the cameras are an important part of the bookscanner. Summary of research about cameras for book scanners:

Basically there are three categories of cameras that can be used for book scanners (from cheapest to most expensive).

1. Remote control support

The cheapest option is any camera with remote trigger support, so we can take pictures without pushing the button on the camera. This is important because when you press the button the camera position may be disadjusted to the physical pressure.

2. CHDK firmware

Middle category is CHDK firmware compatibles. CHDK is a third party open source firmware that allows the customisation of cameras. CHDK firmware is for Canon Powershot cameras, which are the cheaper compact digital camera product line. We have 200 euros in the budget for cameras, so we went with this option.

3. Magic Lantern support

Magic Lantern is a third party open source firmware that is more advanced. However, it only works with Canon DLSR cameras (these are the cameras that have a reflex mirror to look at the shot through a small hole before you take the picture, and they usually have big lenses). The scanner we have now uses Canon 1100D, which are the cheapest type suported by Magic Lantern, but they still cost a few hundred euros.

4. Connecting to a monitor

It is very useful to be able to connect the cameras to a monitor during the calibration process. The cameras we bought use the same output for connecting to a remote control and to a monitor making it not practical at all using a monitor. Furthermore, connection with usb to a computer monitor was not an option, we had to look for RC connectors or adapters.

5. Webcams

Another option could be to use two high resolution webcams directly connected to a laptop to trigger taking pictures and monitor their quality, but the problem with webcams is they almost always have a wide field of view over 90 degrees, making such a solution impossible.

== Building process ==

=== Base / Base ===

[[File:02 BASE 035.JPG|500px|none|left]]
[[File:02 BASE 043.JPG|500px|none|left]]
[[File:02 BASE 040.JPG|500px|none|left]]
We cut the wood beams to have 2 pieces of 56x4cm and 2 of 31.5x4cm

[[File:02 BASE 044.JPG|500px|none|left]]
[[File:02 BASE 041.JPG|500px|none|left]]
we measured with precision tools and marked the position of the drawer sliders on the 54x4cm wood beams

[[File:02 BASE 045.JPG|500px|none|left]]
we drilled holes on the marked position

[[File:02 BASE 049.JPG|500px|none|left]]
[[File:02 BASE 050.JPG|500px|none|left]]
[[File:02 BASE 051.JPG|500px|none|left]]
and then we fixed the sliders

[[File:02 BASE 033.JPG|500px|none|left]]
We used the thicker MDF material to cut a 37x29cm sheet

[[File:02 BASE 056.JPG|500px|none|left]]
The last parts were fixing the other part of the sliders to the MDF sheet and attaching the different part of the base with screws

=== Cradle / Cuna ===
The cradle is a V-shaped book holder partly fixed to the base
[[File:07 GEN 036.JPG|500px|none|left]]
We cut two MDF (thin) sheets for the book holder

[[File:03 CRADDLE 037.JPG|500px|none|left]]
[[File:03 CRADDLE 046.JPG|500px|none|left]]
And 4 small triangles to maintain the book holder on the base with a 90 degree angle between both sheets
[[File:03 CRADDLE 057.JPG|500px|none|left]]
We measured were to position the triangles
[[File:03 CRADDLE 071.JPG|500px|none|left]]
Drilled the MDF sheet on the base
[[File:03 CRADDLE 058.JPG|500px|none|left]]
And fixed the MDF small triangles

[[File:03 CRADDLE 059.JPG|500px|none|left]]
We drilled the MDF sheet of the Craddle
[[File:03 CRADDLE 061.JPG|500px|none|left]]
And fixed it to the triangles

NOT DOCUMENTED WITH PICTURES
[[File:05 COLUMN 066.JPG|500px|none|left]]
The 2 other triangles were fixed to the other MDF sheet without being fixed to the base.
The distance between the triangles is of 19.5cm.
We cut a 19.5x19.5cm MDF square that we attached to the other side of the base.
The drilled the 2 triangles in order to introduce a threaded rod.
The threaded rod is used to tighten the triangles against the square fixed on the base.

=== Platen / Platina ===

[[File:04 PLATEN 039.JPG|500px|none|left]]
[[File:04 PLATEN 047.JPG|500px|none|left]]

[[File:04 PLATEN 053.JPG|500px|none|left]]
[[File:04 PLATEN 054.JPG|500px|none|left]]
[[File:04 PLATEN 055.JPG|500px|none|left]]

[[File:04 PLATEN 063.JPG|500px|none|left]]

=== Column / Columna ===

[[File:05 COLUMN 065.JPG|500px|none|left]]
[[File:05 COLUMN 066.JPG|500px|none|left]]
[[File:05 COLUMN 067.JPG|500px|none|left]]
[[File:05 COLUMN 068.JPG|500px|none|left]]

[[File:05 COLUMN 070.JPG|500px|none|left]]
[[File:05 COLUMN 072.JPG|500px|none|left]]
[[File:05 COLUMN 073.JPG|500px|none|left]]
[[File:05 COLUMN 074.JPG|500px|none|left]]
[[File:05 COLUMN 075.JPG|500px|none|left]]
[[File:05 COLUMN 076.JPG|500px|none|left]]
[[File:05 COLUMN 077.JPG|500px|none|left]]
[[File:05 COLUMN 078.JPG|500px|none|left]]
[[File:05 COLUMN 079.JPG|500px|none|left]]
[[File:05 COLUMN 080.JPG|500px|none|left]]
[[File:05 COLUMN 083.JPG|500px|none|left]]
[[File:05 COLUMN 084.JPG|500px|none|left]]

[[File:06 MOUNTED 086.JPG|500px|none|left]]

=== CHDK ===

=== External trigger ===

[[File:08 TRIGERING 081.JPG|500px|none|left]]
[[File:08 TRIGERING 082.JPG|500px|none|left]]

= Photos =

== Mounting ==

<gallery>
File:06_MOUNTED_064.JPG
File:06_MOUNTED_086.JPG
File:06_MOUNTED_088.JPG
File:06_MOUNTED_089.JPG
</gallery>

== Miscellaneous ==

<gallery>
File:07_GEN_031.JPG
File:07_GEN_034.JPG
File:07_GEN_036.JPG
File:07_GEN_052.JPG
File:07_GEN_085.JPG
</gallery>

== Triggering mechanism ==

<gallery>
File:08_TRIGERING_069.JPG
File:08_TRIGERING_081.JPG
File:08_TRIGERING_082.JPG
</gallery>

== Camera holder ==

<gallery>
File:09_CAM-HOLDERS_087.JPG
File:09_CAM-HOLDERS_090.JPG
</gallery>

== Day 1 (temporary) ==

<gallery>
File:IMG_20181012_161540990.jpg
File:IMG_20181012_161552147.jpg
File:IMG_20181012_161615376.jpg
File:IMG_20181012_161626209.jpg
File:IMG_20181012_161639871.jpg
File:IMG_20181012_162253725.jpg
</gallery>

= Raspberry Pi for the bookscanner =

At the moment we use an electromechanical button documented on the CHDK website that works well but does not do much more than triggering the two cameras to shoot at the same time: http://chdk.wikia.com/wiki/USB_Remote

There are many more possibilities of how to optimise the bookscanning process. Many ideas start with connecting the cameras to a small computer such as the Raspberry Pi. We made some experiments and tests with this setup, which is documented below:

It runs [https://www.raspbian.org/ Raspbian].

== CHDKPTP ==

In /home/pi/chdkptp there are precompiled binaries of [https://app.assembla.com/spaces/chdkptp/wiki CHDKPTP] downloaded from [https://app.assembla.com/spaces/chdkptp/documents here].

CHDKPTP is used for remote control of camera running CHDK firmware.

Our setup has two modes of work:
* mechanical "button" which triggers both camera capturing its photo based on this tutorial: http://chdk.wikia.com/wiki/USB_Remote
* (in progress) Raspberry Pi mode where an bookscanner operator uses Raspberry Pi to capture photos, preview photos in real time and transfer them already renamed for the next step in Scantailor.

When camera is connected this line will list info about the camera e.g.:
<nowiki>sudo ./chdkptp.sh -elist</nowiki>
and for one of the camera this is what is listed then:
<nowiki>-1:Canon IXUS 175 b=001 d=030 v=0x4a9 p=0x32c1 s=8B20D62641B041BAA3E1D597D560D110</nowiki>

An example of capturing a picture from commandline (once in /home/pi/chdkptp/):
<nowiki>sudo ./chdkptp.sh -e"connect -d=030" -erec -eshoot</nowiki>
Above line connects to the camera sitting on -d=021, puts it into rec mode (if not already) and capture the photo saving it to SD card already in camera. If one wants to bypass the SD card altogether it should replace -eshoot with -eremoteshoot. In that case ./chdkptp.sh will save photos into the directory from where it was called.

Note: check the SD card is locked.

== ZeroTier ==

It is added to 565799d8f6ebf1a8 public network of [https://zerotier.com ZeroTier] with this command:
<nowiki>sudo zerotier-cli join 565799d8f6ebf1a8</nowiki>
and it got static IP address (in 565799d8f6ebf1a8 network):
<nowiki>192.168.192.171/24</nowiki>

In /home/pi/.ssh/authorized_keys public keys of maxigas and marcell are added.

= Ideas for building Voja's scanner =

Our first idea was to reproduce Voja's scanner but we had to realise that we are not Voja and the scanner is very beautiful and unique engineering and consequently it is hard to reproduce.

Here are two links to the public documentation of our scanner, built by Voja Antonic:

https://www.memoryoftheworld.org/blog/2012/10/28/our-beloved-bookscanner-2/

https://hackaday.io/project/5604-diy-book-scanner

The electronics is not really documented (which means that it is hard to reproduce) and it is built from basic parts (which means that it takes a lot of time to put it together). So we brainstorm about an Arduino-based solution instead. Arduino is a general-purpose programmable microcontroller that has already built-in many of the functions/parts we need. The idea is that this makes it easier for us to build the scanner and for others to reproduce it. We also have more experience working with Arduino than with only basic electronic components.

We will also try to use cheaper cameras in order to bring down the budget.

= Biblio-graphy =

== About our first bookscanner ==

[https://www.memoryoftheworld.org/blog/2012/10/28/our-beloved-bookscanner/ English]

[https://www.memoryoftheworld.org/es/blog/2012/10/28/our-beloved-bookscanner/ Spanish]

== Principal sources ==

[http://en.flossmanuals.net/e-book-enlightenment/ Reading And Leading With One Laptop Per Child]

== Future activities ==

[[next steps]]

Bookscanning

2019-03-06T07:10:46Z

Brinerustle: /* Dependencies */

There are many ways to scan, this is the current state of the art in Calafou. We use only free software and the documentation is for Debian GNU/Linux, but it should work with some small modifications on any UNIX based system running the bash shell. There are some parts where proprietary software such as ABBYY FineReader can be more effective. However, this workflow produces near perfect books in PDF format that we are very happy with. One thing we could definitely improve is the size of the final PDF file, which is quite big (can be more than 100 megabytes).

= Scanning =

'''The amount of work in the postproduction phase depends on how good quality images you can make in the scanning phase!'''

[[File:CameraSettings.png| 300px |none | left ]]

# Setting up the cameras (calibration): the most important part.

* open the book in the middle (at a central page with normal text on both sides)
* '''camera should look directly on the middle of the page, parallel to the cradle, at 45 degrees compared to horizontal'''.
* If you want to use the button to make the cameras trigger automatically, you must lock the SD cards before putting them in. Also, plug the many USB cables in.
* check all x, y and z angles.
* all the page should be in the image, but it is not a problem if more things outside of the book are visible
* check if the pages fold/curve; if so, place something underneath to straighten it (like a sponge, or another book…)
* camera settings: fully automatic, perhaps with manual focus
* back up and empty the SD cards in the cameras
* most subtle mistake: one camera sees letters bigger than the other camera (this can be a difference in the zoom level or the distance between camera and page)
* use a post-it or similar to mark the exact position of the book in relation to the lower edge of the cradle, to ensure it remains in the same position throughout the scanning

<ol start="2" style="list-style-type: decimal;">
<li>Push the big button on the scanner to scan.</li></ol>

* maybe you have to put your finger to the side of the plexiglass which is closer to you when it is “down”, because the plexiglass is not always exactly the same angle as the book pages

* TURN OFF THE CAMERAS BEFORE REMOVING THE SD CARDS! (otherwise, pics will be erased!)

<ol start="3" style="list-style-type: decimal;">
<li>Download the images from the SD cards and put the scanner to sleep.</li></ol>

* from the camera on the left, copy the images to a folder called “odd”
* from the camera on the right, copy the images to a folder called “even”
* upload the two folders now to to <code>ftp://omnius.calafou/HackTheBiblio/scanning/$bookname--$yourname/</code> folder
* remember to delete the pictures from the SD cards and put them back to the cameras, and maybe put the camera batteries to charge

'''Additional information using the marron_scanner 😎 '''
* Check before starting that the SD card are locked: the external trigger that controls the cameras requires the SD cards to be locked. If they are not locked, the pictures are not saved when using the external trigger.
* Camera settings: we use two IXUS 175 set to '''automatic''' with menu/lamp setting set to '''"off"''' to avoid the use of the red light.
* While taking pictures, if you need to check the last picture taken: long press the green play button to enter slideshow mode, long press the green play button to go back to picture mode (half pressure on the camera trigger also works)
* If you decide to use the zoom of the camera (not the digital zoom), be careful not to turn off the camera or you will loose your zoom setting

= Dependencies =

Using an up-to-date Debian operating system, you can install the following programs for the postproduction steps:

* scantailor
* gprename
* pdftk
* tesseract-ocr
* tesseract-ocr-eng
* tesseract-ocr-spa
* calibre

You can install all these programs with the following invocation from the command line (also called the terminal):

<pre>sudo apt install scantailor gprename pdftk tesseract-ocr tesseract-ocr-eng tesseract-ocr-spa calibre</pre>

Some users may not find pdftk in the repositories. An alternative is pdfshuffler, which has a graphical user interface

= Postproduction =

You start with two folders such as <code>odd</code> and <code>even</code> with files like IMG_1234.JPG. It is not good to talk about <code>right</code> and <code>left</code> because it can be very confusing: are you talking about the image from the right camera that takes pictures of the left page of the book, or the image of the left page of the book that is from the right camera? On the other hand, <code>odd</code> (1, 3, 5, …) and <code>even</code> (2, 4, 6, …) are good words for describing what is on the image without ambiguity!

The basic workflow is like this:

<ol start="0" style="list-style-type: decimal;">
<li> [process] → [program] → [output]</li>
<li> Merge pictures from the two cameras → gprename → 1.jpg, 2.jpg, …</li>
<li> Edit the pictures to adjust contents → scantailor → 1.tif, 2.tif, …</li>
<li> Character recognition → tesseract → 1.pdf, 2.pdf, …</li>
<li> Create the pdf file → pdftk → book.pdf</li>
<li> Create the ebook → calibre → book.epub</li>
<li> Disseminate → libgen.org → http://libgen.org/book/index.php?md5=B6916395FDE00D91DB4F52DCB8F069BF</li>
<li>etc.</li></ol>

There are some bash oneliners which can be useful (on Debian based systems):

<ol style="list-style-type: decimal;">
<li> <code>gprename</code>
* enter <code>gprename</code> using a Terminal
* go to the Directory with the odd files
* select all files
* go to the numerical tab
* set starting number to 1 and increment by 2
* set the naming pattern

[[File:Gprename.png|gprename window for renaming files | 300px |none | left ]]

* repeat the operation for even files
* merge the two folders
* to rename the files properly, place <code>.JPG</code> in the "After the number" section above. </li>
* WHAT'S THIS ??? -> <code>FIXME</code> we can probably write a script to rename the files properly…</li> ??? does it just talk about the .JPG in the step above?
<li> <code> scantailor </code>

You can edit the captures appropriately with [http://scantailor.org/ scantailor]. It invites you to follow these steps:

*'''1st step: Fix orientation'''. All odd pages need to be turned in one direction, while even pages need to be turned in the other direction.

[[File:Rotate.png | 300px |none | left ]]

Rotate image nr 1 and click on "apply to every other page". Then select image nr 2, rotate in the opposite direction so it stays still, and also click on "apply to every other page".

[Fix Orientation Manual -> https://github.com/scantailor/scantailor/wiki/Fix-Orientation]

*'''2nd step: Split pages'''. If you import all files renamed, odd and even pages will be recognized as single pages, so this step is just to confirm that the edges of the pages are set properly; drag the rectangles to fit in the page's area.

[[File:SplitPages.png | 300px |none | left ]]

[Split pages manual -> https://github.com/scantailor/scantailor/wiki/Split-Pages]

*'''3rd step: Deskew'''. Drag and determine the angle which the page needs to be turned for the text and images to be properly horizontal.

[[File:Deskew main tab.jpeg | 300px |none | left ]]

[Deskew manual -> https://github.com/scantailor/scantailor/wiki/Deskew]

*'''4th step: Select content'''. Frame all elements to be shown as content, within one single area (beware of including for example page numbers). The outer limit of these margins affects the size of the output file.

[[File:Content main tab.jpeg | 300px |none | left ]]

[Select content manual -> https://github.com/scantailor/scantailor/wiki/Select-Content]

*'''5th step: Margins'''. Check out all margins so they are set to zero. Then, place the content in a manner that will help it being read "centralized".

[[File:Margins to zero.png | 300px |none | left ]]
[[File:Center.png | 300px |none | left ]]

[Margins management manual -> https://github.com/scantailor/scantailor/wiki/Page-Layout]

*'''6th step: Output'''. Consider the visibility/readability of pages with images and/or mixed img-txt, managing the thickness slider. Check every tab on the column that emerged on the right:
- Picture Zones: use the tool to select areas with photographs, illustrations or special icons.
- Dewarping: manage the grid to stregthen your page's content.
- Desplekling: remove dust and dots from the page.

[[File:Dewarping.png | 300px |none | left ]]

[Output manual -> https://github.com/scantailor/scantailor/wiki/Output]

<li>Does Optical Character Recognition (OCR) on all images in folder:
<pre> time for i in *tif; do b=$(basename $i .tif); tesseract -l spa "$i" "$b" pdf; done</pre></li>
<li>Merges all the pdf files in folder into one single file:
<pre> pdftk *pdf cat output book.pdf</pre></li>
<li>Exports the pdf metadata to a text file, to edit:
<pre> pdftk book.pdf dump_data output report.txt</pre></li>
<li>Imports the metadata of report.txt back to the PDF:
<pre> pdftk book.pdf update_info report.txt output bookcopy.pdf</pre></li></ol>

We recommend to use '''Calibre''' for your e-book management tasks -> https://calibre-ebook.com/

= Distribution =

Think about how people who would be interested in this book could know about it!

Repositories:

* General “educational materials”: [https://libgen.io/ Library Genesis]
* Academic radical: [https://aaaaarg.org/ Aaaaarg]
* Artist radical: [https://monoskop.org/ Monoskop]
* Anarchist (including fanzines): [https://theanarchistlibrary.org/special/index Anarchist Library]
* There are many Zine Libraries you can find on the Internet…

You may consider spreading the word on relevant mailing lists, social media, etc.

= Biblio-graphy =

* [https://www.memoryoftheworld.org/wp-content/uploads/2014/12/scanning_manual_v1.2.pdf Scanning Manual from Memory of the World]: a quite long document in PDF
* [https://www.memoryoftheworld.org/ Memory of the World]: Digital Public Libraries
* [https://www.memoryoftheworld.org/es/ Spanish pages on Memory of the World]: Digital Public Libraries in Spanish
* [http://en.flossmanuals.net/e-book-enlightenment/ Reading And Leading With One Laptop Per Child]: Book digitalisation manual

Bookscanning

2019-01-25T15:15:06Z

Brinerustle:

There are many ways to scan, this is the current state of the art in Calafou. We use only free software and the documentation is for Debian GNU/Linux, but it should work with some small modifications on any UNIX based system running the bash shell. There are some parts where proprietary software such as ABBYY FineReader can be more effective. However, this workflow produces near perfect books in PDF format that we are very happy with. One thing we could definitely improve is the size of the final PDF file, which is quite big (can be more than 100 megabytes).

= Scanning =

'''The amount of work in the postproduction phase depends on how good quality images you can make in the scanning phase!'''

[[File:CameraSettings.png| 300px |none | left ]]

# Setting up the cameras (calibration): the most important part.

* open the book in the middle (at a central page with normal text on both sides)
* '''camera should look directly on the middle of the page, parallel to the cradle, at 45 degrees compared to horizontal'''.
* If you want to use the button to make the cameras trigger automatically, you must lock the SD cards before putting them in. Also, plug the many USB cables in.
* check all x, y and z angles.
* all the page should be in the image, but it is not a problem if more things outside of the book are visible
* check if the pages fold/curve; if so, place something underneath to straighten it (like a sponge, or another book…)
* camera settings: fully automatic, perhaps with manual focus
* back up and empty the SD cards in the cameras
* most subtle mistake: one camera sees letters bigger than the other camera (this can be a difference in the zoom level or the distance between camera and page)
* use a post-it or similar to mark the exact position of the book in relation to the lower edge of the cradle, to ensure it remains in the same position throughout the scanning

<ol start="2" style="list-style-type: decimal;">
<li>Push the big button on the scanner to scan.</li></ol>

* maybe you have to put your finger to the side of the plexiglass which is closer to you when it is “down”, because the plexiglass is not always exactly the same angle as the book pages

<ol start="3" style="list-style-type: decimal;">
<li>Download the images from the SD cards and put the scanner to sleep.</li></ol>

* from the camera on the left, copy the images to a folder called “odd”
* from the camera on the right, copy the images to a folder called “even”
* upload the two folders now to to <code>ftp://omnius.calafou/HackTheBiblio/scanning/$bookname--$yourname/</code> folder
* remember to delete the pictures from the SD cards and put them back to the cameras, and maybe put the camera batteries to charge

'''Additional information using the Marron_scanner '''
* Check before starting that the SD card are locked: the external trigger that controls the cameras requires the SD cards to be locked. If they are not locked, the pictures are not saved when using the external trigger.
* Camera settings: we use two IXUS 175 set to '''automatic''' with menu/lamp setting set to '''"off"''' to avoid the use of the red light.
* While taking pictures, if you need to check the last picture taken: long press the green play button to enter slideshow mode, long press the green play button to go back to picture mode (half pressure on the camera trigger also works)
* If you decide to use the zoom of the camera (not the digital zoom), be careful not to turn off the camera or you will loose your zoom setting

= Dependencies =

Using an up-to-date Debian operating system, you can install the following programs for the postproduction steps:

* scantailor
* gprename
* pdftk
* tesseract-ocr
* tesseract-ocr-eng
* tesseract-ocr-spa
* calibre

You can install all these programs with the following invocation from the command line (also called the terminal):

<pre>sudo apt install scantailor gprename pdftk tesseract-ocr tesseract-ocr-eng tesseract-ocr-spa calibre</pre>

= Postproduction =

You start with two folders such as <code>odd</code> and <code>even</code> with files like IMG_1234.JPG. It is not good to talk about <code>right</code> and <code>left</code> because it can be very confusing: are you talking about the image from the right camera that takes pictures of the left page of the book, or the image of the left page of the book that is from the right camera? On the other hand, <code>odd</code> (1, 3, 5, …) and <code>even</code> (2, 4, 6, …) are good words for describing what is on the image without ambiguity!

The basic workflow is like this:

<ol start="0" style="list-style-type: decimal;">
<li> [process] → [program] → [output]</li>
<li> Merge pictures from the two cameras → gprename → 1.jpg, 2.jpg, …</li>
<li> Edit the pictures to adjust contents → scantailor → 1.tif, 2.tif, …</li>
<li> Character recognition → tesseract → 1.pdf, 2.pdf, …</li>
<li> Create the pdf file → pdftk → book.pdf</li>
<li> Create the ebook → calibre → book.epub</li>
<li> Disseminate → libgen.org → http://libgen.org/book/index.php?md5=B6916395FDE00D91DB4F52DCB8F069BF</li>
<li>etc.</li></ol>

There are some bash oneliners which can be useful (on Debian based systems):

<ol style="list-style-type: decimal;">
<li> <code>gprename</code>
* enter <code>gprename</code> using a Terminal
* go to the Directory with the odd files
* select all files
* go to the numerical tab
* set starting number to 1 and increment by 2
* set the naming pattern

[[File:Gprename.png|gprename window for renaming files | 300px |none | left ]]

* repeat the operation for even files
* merge the two folders
* to rename the files properly, place <code>.JPG</code> in the "After the number" section above. </li>
* WHAT'S THIS ??? -> <code>FIXME</code> we can probably write a script to rename the files properly…</li> ??? does it just talk about the .JPG in the step above?
<li> <code> scantailor </code>

You can edit the captures appropriately with [http://scantailor.org/ scantailor]. It invites you to follow these steps:

*'''1st step: Fix orientation'''. All odd pages need to be turned in one direction, while even pages need to be turned in the other direction.

[[File:Rotate.png | 300px |none | left ]]

Rotate image nr 1 and click on "apply to every other page". Then select image nr 2, rotate in the opposite direction so it stays still, and also click on "apply to every other page".

[Fix Orientation Manual -> https://github.com/scantailor/scantailor/wiki/Fix-Orientation]

*'''2nd step: Split pages'''. If you import all files renamed, odd and even pages will be recognized as single pages, so this step is just to confirm that the edges of the pages are set properly; drag the rectangles to fit in the page's area.

[[File:SplitPages.png | 300px |none | left ]]

[Split pages manual -> https://github.com/scantailor/scantailor/wiki/Split-Pages]

*'''3rd step: Deskew'''. Drag and determine the angle which the page needs to be turned for the text and images to be properly horizontal.

[[File:Deskew main tab.jpeg | 300px |none | left ]]

[Deskew manual -> https://github.com/scantailor/scantailor/wiki/Deskew]

*'''4th step: Select content'''. Frame all elements to be shown as content, within one single area (beware of including for example page numbers). The outer limit of these margins affects the size of the output file.

[[File:Content main tab.jpeg | 300px |none | left ]]

[Select content manual -> https://github.com/scantailor/scantailor/wiki/Select-Content]

*'''5th step: Margins'''. Check out all margins so they are set to zero. Then, place the content in a manner that will help it being read "centralized".

[[File:Margins to zero.png | 300px |none | left ]]
[[File:Center.png | 300px |none | left ]]

[Margins management manual -> https://github.com/scantailor/scantailor/wiki/Page-Layout]

*'''6th step: Output'''. Consider the visibility/readability of pages with images and/or mixed img-txt, managing the thickness slider. Check every tab on the column that emerged on the right:
- Picture Zones: use the tool to select areas with photographs, illustrations or special icons.
- Dewarping: manage the grid to stregthen your page's content.
- Desplekling: remove dust and dots from the page.

[[File:Dewarping.png | 300px |none | left ]]

[Output manual -> https://github.com/scantailor/scantailor/wiki/Output]

<li>Does Optical Character Recognition (OCR) on all images in folder:
<pre> time for i in *tif; do b=$(basename $i .tif); tesseract -l spa "$i" "$b" pdf; done</pre></li>
<li>Merges all the pdf files in folder into one single file:
<pre> pdftk *pdf cat output book.pdf</pre></li>
<li>Exports the pdf metadata to a text file, to edit:
<pre> pdftk book.pdf dump_data output report.txt</pre></li>
<li>Imports the metadata of report.txt back to the PDF:
<pre> pdftk book.pdf update_info report.txt output bookcopy.pdf</pre></li></ol>

We recommend to use '''Calibre''' for your e-book management tasks -> https://calibre-ebook.com/

= Distribution =

Think about how people who would be interested in this book could know about it!

Repositories:

* General “educational materials”: [https://libgen.io/ Library Genesis]
* Academic radical: [https://aaaaarg.org/ Aaaaarg]
* Artist radical: [https://monoskop.org/ Monoskop]
* Anarchist (including fanzines): [https://theanarchistlibrary.org/special/index Anarchist Library]
* There are many Zine Libraries you can find on the Internet…

You may consider spreading the word on relevant mailing lists, social media, etc.

= Biblio-graphy =

* [https://www.memoryoftheworld.org/wp-content/uploads/2014/12/scanning_manual_v1.2.pdf Scanning Manual from Memory of the World]: a quite long document in PDF
* [https://www.memoryoftheworld.org/ Memory of the World]: Digital Public Libraries
* [https://www.memoryoftheworld.org/es/ Spanish pages on Memory of the World]: Digital Public Libraries in Spanish
* [http://en.flossmanuals.net/e-book-enlightenment/ Reading And Leading With One Laptop Per Child]: Book digitalisation manual

Bookscanning

2019-01-24T17:49:05Z

Brinerustle: two lines didn't work for me

There are many ways to scan, this is the current state of the art in Calafou. We use only free software and the documentation is for Debian GNU/Linux, but it should work with some small modifications on any UNIX based system running the bash shell. There are some parts where proprietary software such as ABBYY FineReader can be more effective. However, this workflow produces near perfect books in PDF format that we are very happy with. One thing we could definitely improve is the size of the final PDF file, which is quite big (can be more than 100 megabytes).

= Scanning =

'''The amount of work in the postproduction phase depends on how good quality images you can make in the scanning phase!'''

# Setting up the cameras (calibration): the most important part.

* open the book in the middle (at a central page with normal text on both sides)
* '''camera should look directly on the middle of the page, parallel to the cradle, at 45 degrees compared to horizontal'''
* all the page should be in the image, but it is not a problem if more things outside of the book are visible
* check if the pages fold/curve; if so, place something underneath to straighten it (like a sponge, or another book…)
* camera settings: fully automatic, perhaps with manual focus
* back up and empty the SD cards in the cameras
* most subtle mistake: one camera sees letters bigger than the other camera (this can be a difference in the zoom level or the distance between camera and page)
* use a post-it or similar to mark the exact position of the book in relation to the lower edge of the cradle, to ensure it remains in the same position throughout the scanning

<ol start="2" style="list-style-type: decimal;">
<li>Push the big button on the scanner to scan.</li></ol>

* maybe you have to put your finger to the side of the plexiglass which is closer to you when it is “down”, because the plexiglass is not always exactly the same angle as the book pages

<ol start="3" style="list-style-type: decimal;">
<li>Download the images from the SD cards and put the scanner to sleep.</li></ol>

* from the camera on the left, copy the images to a folder called “odd”
* from the camera on the right, copy the images to a folder called “even”
* upload the two folders now to to <code>ftp://omnius.calafou/HackTheBiblio/scanning/$bookname--$yourname/</code> folder
* remember to delete the pictures from the SD cards and put them back to the cameras, and maybe put the camera batteries to charge

'''Additional information using the Marron scanner'''

* Check before starting that the SD card are locked: the external trigger that controls the cameras requires the SD cards to be locked. If they are not locked, the pictures are not saved when using the external trigger.
* Camera settings: we use two IXUS 175 set to automatic with menu/lamp setting set to "off" to avoid the use of the red light
* While taking pictures, if you need to check the last picture taken: long press the green play button to enter slideshow mode, long press the green play button to go back to picture mode (half pressure on the camera trigger also works)
* If you decide to use the zoom of the camera (not the digital zoom), be careful not to turn off the camera or you will loose your zoom setting

= Dependencies =

Using an up-to-date Debian operating system, you can install the following programs for the postproduction steps:

* scantailor
* gprename
* pdftk
* tesseract-ocr
* tesseract-ocr-eng
* tesseract-ocr-spa
* calibre

You can install all these programs with the following invocation from the command line (also called the terminal):

<pre>sudo apt install scantailor gprename pdftk tesseract-ocr tesseract-ocr-eng tesseract-ocr-spa calibre</pre>

= Postproduction =

You start with two folders such as <code>odd</code> and <code>even</code> with files like IMG_1234.JPG. It is not good to talk about <code>right</code> and <code>left</code> because it can be very confusing: are you talking about the image from the right camera that takes pictures of the left page of the book, or the image of the left page of the book that is from the right camera? On the other hand, <code>odd</code> (1, 3, 5, …) and <code>even</code> (2, 4, 6, …) are good words for describing what is on the image without ambiguity!

The basic workflow is like this:

<ol start="0" style="list-style-type: decimal;">
<li> [process] → [program] → [output]</li>
<li> Merge pictures from the two cameras → gprename → 1.jpg, 2.jpg, …</li>
<li> Edit the pictures to adjust contents → scantailor → 1.tif, 2.tif, …</li>
<li> Character recognition → tesseract → 1.pdf, 2.pdf, …</li>
<li> Create the pdf file → pdftk → book.pdf</li>
<li> Create the ebook → calibre → book.epub</li>
<li> Disseminate → libgen.org → http://libgen.org/book/index.php?md5=B6916395FDE00D91DB4F52DCB8F069BF</li>
<li>etc.</li></ol>

There are some bash oneliners which can be useful (on Debian based systems):

<ol style="list-style-type: decimal;">
<li> <code>gprename</code>
* enter <code>gprename</code> using a Terminal
* go to the Directory with the odd files
* select all files
* go to the numerical tab
* set starting number to 1 and increment by 2
* set the naming pattern

[[File:Gprename.png|gprename window for renaming files]]

* repeat the operation for even files
* merge the two folders
* <code>FIXME</code> we can probably write a script to rename the files properly…</li>
<li> <code> scantailor </code>

You can edit the captures appropriately with [http://scantailor.org/ scantailor]. Steps:

1st step: Fix orientation
2nd step: Split pages
3rd step: Deskew
4th step: Select content
5th step: Margins
6th step: Output

(which is called “fix orientation” in scantailor) in the left/right folders before you import them. This is faster than in <code>scantailor</code> I think. However, you can also make the same operation in <code>scantailor</code> in a more user friendly way.
<pre> sudo apt-get install imagemagick
cd odd
mogrify -verbose -rotate 270 *
cd ../even
mogrify -verbose -rotate 90 *</pre></li>
<li>Does Optical Character Recognition (OCR) on all images in folder:
<pre> time for i in *tif; do b=$(basename $i .tif); tesseract -l spa "$i" "$b" pdf; done</pre></li>
<li>Merges all the pdf files in folder into one single file:
<pre> pdftk *pdf cat output book.pdf</pre></li>
<li>Exports the pdf metadata to a text file, to edit:
<pre> pdftk book.pdf dump_data output report.txt</pre></li>
<li>Imports the metadata of report.txt back to the PDF:
<pre> pdftk book.pdf update_info report.txt output bookcopy.pdf</pre></li></ol>

= Distribution =

Think about how people who would be interested in this book could know about it!

Repositories:

* General “educational materials”: [https://libgen.io/ Library Genesis]
* Academic radical: [https://aaaaarg.org/ Aaaaarg]
* Artist radical: [https://monoskop.org/ Monoskop]
* Anarchist (including fanzines): [https://theanarchistlibrary.org/special/index Anarchist Library]
* There are many Zine Libraries you can find on the Internet…

You may consider spreading the word on relevant mailing lists, social media, etc.

= Biblio-graphy =

* [https://www.memoryoftheworld.org/wp-content/uploads/2014/12/scanning_manual_v1.2.pdf Scanning Manual from Memory of the World]: a quite long document in PDF
* [https://www.memoryoftheworld.org/ Memory of the World]: Digital Public Libraries
* [https://www.memoryoftheworld.org/es/ Spanish pages on Memory of the World]: Digital Public Libraries in Spanish
* [http://en.flossmanuals.net/e-book-enlightenment/ Reading And Leading With One Laptop Per Child]: Book digitalisation manual