littleprynter/README.md

76 lines
2.6 KiB
Markdown

# Little Prynter
---
> Print out shit from the cloud.
## About
This project started when I got a Thermal Printer from a friend. I don't really know if you can do anything more, but I guess it's fun.
## Requirements
To make this project work, you will need :
- [A Thermal Printer](https://www.adafruit.com/product/597)
- A Raspberry Pi
- Some electric wires.
- Some knowledge of the command line
- 3h of your time
## Installation
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.
Then, setup the project :
```
git clone https://git.n07070.xyz/n07070/LittlePrynter
cd LittlePrynter
pip install -r requirements.txt
```
Now, edit `the users.json` and add a user. **Don't forget to remove the test user.**
You can now start the web server with
```
export FLASK_APP=littleprynter.py
flask run
```
Voilà !
## More
If you liked this project, feel free to support my work !
[https://n07070.xyz/post/about-me/about-me/](Donations welcome :-])
## 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/>.
```