99 lines
4.6 KiB
Markdown
99 lines
4.6 KiB
Markdown
# Little Prynter
|
|
---
|
|
|
|
> Print out shit from the cloud on a thermal paper.
|
|
|
|
<img src="src/static/images/little-printer.png" style="padding:auto">
|
|
|
|
|
|
|
|
## About
|
|
|
|
This project started when I got a Thermal Printer from a friend. It's now evolved to a complete web solution to print out text and images.
|
|
|
|
## Requirements
|
|
|
|
To make this project work, you will need :
|
|
- A Thermal Printer :
|
|
- I used *Adafruit's thermal printer* at first, but it broke down. You can get it [here](https://www.adafruit.com/product/597).
|
|
- I then used an *EPSON TM-T2OIII*. It's expensive, but it's also high quality, and has better CUPS and specific library support.
|
|
- A Raspberry Pi or any computer with USB or Serial.
|
|
- Some electric wires.
|
|
- Some knowledge of the command line,
|
|
- Some knowledge of Python.
|
|
- 3h of your time, 5h if things need debugging.
|
|
- `git`, `virtualenv`,`pip` and `python` >= 3.8.6.
|
|
- A webcam for the webcam page to work. Will work on a smartphone. Not required.
|
|
|
|
## Context
|
|
|
|
For the EPSON TM-T20III, you can get the CUPS driver from [here](https://download.epson-biz.com/modules/pos/index.php?page=soft&scat=32). It's not specific to the printer I've been using, so you can try with other printers.
|
|
|
|
With that, you can try out your printer and print normal text, images or pdf documents for example. LittlePrynter itself does not require any other software than the ones installed with it, i.e the ones listed in the `requirements.txt` file.
|
|
|
|
For the Adafruit printer, start by following the guide [here](https://learn.adafruit.com/networked-thermal-printer-using-cups-and-raspberry-pi) to install the CUPS software needed to print images. If you want, you can install it via the command line, [following this guide](https://help.ubuntu.com/lts/serverguide/cups.html).
|
|
|
|
You can also get some information from [here](https://learn.adafruit.com/mini-thermal-receipt-printer) and [here](https://learn.adafruit.com/instant-camera-using-raspberry-pi-and-thermal-printer) if you're stuck.
|
|
|
|
The version for the EPSON TM-T20III uses a library called `python-escpos`, which doesn't need a CUPS driver or anything else. It's included in the Python dependencies.
|
|
|
|
The project only supports the EPSON printer, but you can try to adapt it for other printers using the `adafruit-thermal` branch, but I won't offer support for it.
|
|
|
|
### Install & setup the project :
|
|
```
|
|
$ git clone https://git.n07070.xyz/n07070/LittlePrynter
|
|
$ virtualenv LittlePrynter
|
|
$ cd LittlePrynter
|
|
$ source bin/activate
|
|
$ pip install -r requirements.txt
|
|
```
|
|
|
|
> tip : when you're done, you can get out of the virtualenv either by closing your terminal, or by running `deactivate`.
|
|
|
|
You should see a folder named `configuration`. Enter it, and duplicate the file named `config.toml.sample`, and rename the copy to `config.toml`. Now, edit this file by following the comments in the file itself.
|
|
|
|
You can now start the web server with
|
|
|
|
```
|
|
$ export FLASK_APP=src/main.py
|
|
$ flask run
|
|
```
|
|
|
|
This command should start a web server with which you can test your configuration. If you plan on exposing your printer to the Internet, and give it an IP / URL, _please, please, please_, don't run it this way. Look at Flask's documentation and read about running a production server. It's a little more work, but it will prevent your computer/server being hacked in too easily.
|
|
|
|
Voilà !
|
|
|
|
## More
|
|
|
|
If you liked this project, feel free to support my work !
|
|
|
|
[Donations welcome ! :)](https://n07070.xyz/about-me)
|
|
|
|
## Links
|
|
|
|
- [A blog post about some CUPS configuration](http://scruss.com/blog/2015/07/12/thermal-printer-driver-for-cups-linux-and-raspberry-pi-zj-58/)
|
|
- [Github repo with CUPS drivers for the Adafruit Thermal Printer ( zj-58 )](https://github.com/klirichek/zj-58)
|
|
- [A link to buy one in Europe](https://rlx.sk/sk/various-boards/1829-mini-thermal-receipt-printer-adafruit-597.html)
|
|
- [Another link to buy one, direct from factory](https://www.cashinotech.com/csn-a2-58mm-mini-panel-thermal-receipt-printer_p11.html)
|
|
|
|
|
|
## Licence
|
|
|
|
```
|
|
LittlePrynter
|
|
Copyright (C) 2020 N07070
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
```
|