Update README and screenshots
89
README.md
@@ -1,71 +1,94 @@
|
||||
# NiimBlue
|
||||
<div align="center">
|
||||
|
||||
NIIMBOT printers webui. Design and print labels right from your browser.
|
||||
[](https://niim.blue)
|
||||
|
||||
Uses [NiimBlueLib](https://github.com/MultiMote/niimbluelib) for communication.
|
||||
# NIIMBOT printers webui
|
||||
|
||||
Project is deployed here: [niim.blue](https://niim.blue)
|
||||
Design and print labels right from your browser
|
||||
|
||||
> [!NOTE]
|
||||
> If you have printing problems, try different print task versions in print preview dialog. Make if default by pressing "Lock" button.
|
||||
>
|
||||
> If you found version suitable for your model, please write [here](https://github.com/MultiMote/niimbluelib/issues/1).
|
||||
>
|
||||
> Also read [Frequently asked questions](https://github.com/MultiMote/niimblue/wiki/Frequently-asked-questions).
|
||||
[FAQ](https://github.com/MultiMote/niimblue/wiki/Frequently-asked-questions) | [Discord](https://discord.gg/jXPAfZVd8a) | [Telegram](https://t.me/niimblue) | [Boosty](https://boosty.to/multimote) | [NIIMBOT Community Wiki](https://printers.niim.blue)
|
||||
|
||||
[NiimBlueLib](https://github.com/MultiMote/niimbluelib) is used for communication
|
||||
|
||||
</div>
|
||||
|
||||
## Features
|
||||
|
||||
Key features:
|
||||
|
||||
* Privacy first! This application works completely offline and does not send any data (except for downloading application files and importing ZPL labels). Label data is stored in your browser.
|
||||
* Privacy first! This application works completely offline (at browser side) and does not send any data (except for downloading application files and importing ZPL labels). Label data is stored in your browser.
|
||||
* Support for both Bluetooth and USB connections.
|
||||
* Rich label editor. Label saving, import/export.
|
||||
* Print preview. You can see how your label will look like after post-processing. Several post-processing algorithms are available.
|
||||
* Android App (Capacitor based).
|
||||
* Most complete implementation of [NIIMBOT protocol](https://niim-docs.pages.dev/documents/NIIMBOT_printers_protocol.html).
|
||||
* Most complete implementation of [NIIMBOT protocol](https://printers.niim.blue/interfacing/proto/).
|
||||
|
||||
You can see the full list of implemented and planned features [on the Wiki](https://github.com/MultiMote/niimblue/wiki#features).
|
||||
|
||||
List of tested models you can find in [niimbluelib](https://github.com/MultiMote/niimbluelib/issues/1) repository.
|
||||
You can see more complete list of implemented and planned features [on the Wiki](https://github.com/MultiMote/niimblue/wiki#features).
|
||||
|
||||
Demonstration video:
|
||||
|
||||
[](https://www.youtube.com/watch?v=u8QX-5e3W_A)
|
||||
|
||||
## Browser support
|
||||
## Supported printers
|
||||
|
||||
There is no exact list of supported models in this project. This project aims to support the maximum number of models.
|
||||
|
||||
You can check [a list of tested models here](https://github.com/MultiMote/niimbluelib/issues/1). If you own other model, please write a comment.
|
||||
|
||||
If your (new) printer model does not print, please make a [packet dump](https://github.com/MultiMote/niimblue/wiki/Making-packet-capture) of print with official application.
|
||||
|
||||
> [!NOTE]
|
||||
> If you have printing problems, try different print task versions in print preview dialog. Make if default by pressing "Lock" button.
|
||||
|
||||
|
||||
## Supported browsers
|
||||
|
||||
Your browser must support Web Bluetooth API: [supported browsers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Bluetooth_API#browser_compatibility).
|
||||
|
||||
For serial communication: [supported browsers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Serial_API#browser_compatibility).
|
||||
|
||||
In some systems you need to enable Chrome `Experimental Web Platform Features` (navigate to `chrome://flags`).
|
||||
Modern Chrome-based browsers should usually work.
|
||||
|
||||
## Feedback needed!
|
||||
|
||||
I only have D110 and B1 printers. If you own other models, please write a comment [here](https://github.com/MultiMote/niimbluelib/issues/1) describing your model working or not.
|
||||
|
||||
Bluetooth dumps are MUCH appreciated. [How to make it](https://github.com/MultiMote/niimblue/wiki/Making-packet-capture).
|
||||
In some systems you need to enable Chrome `Web Bluetooth` or `Experimental Web Platform Features` (navigate to `chrome://flags`).
|
||||
|
||||
## Images
|
||||
|
||||
Images may be outdated, interface is changing constantly.
|
||||
Images may be outdated.
|
||||
|
||||

|
||||
|
||||
<details>
|
||||
<summary>⬇ More images ⬇</summary>
|
||||
|
||||
Label properties:
|
||||
|
||||

|
||||
|
||||
Save/load menu:
|
||||
|
||||

|
||||
|
||||
Print preview dialog:
|
||||
|
||||

|
||||
|
||||
Post-processing:
|
||||
|
||||

|
||||
|
||||
Templating:
|
||||
|
||||

|
||||
|
||||
Dynamic data:
|
||||
|
||||

|
||||
|
||||
In real life:
|
||||
|
||||

|
||||
|
||||

|
||||
</details>
|
||||
|
||||
|
||||
## Launching development server
|
||||
|
||||
@@ -89,7 +112,7 @@ Skip steps you have done.
|
||||
|
||||
5. Run dev server
|
||||
|
||||
Check code and open browser:
|
||||
Check code and run:
|
||||
|
||||
```bash
|
||||
npm run dev-check
|
||||
@@ -101,15 +124,9 @@ Skip steps you have done.
|
||||
npm run dev
|
||||
```
|
||||
|
||||
## Translation status
|
||||
To run own instance, build static files (`npm run build`) and host on yor web server,
|
||||
or use [Docker Image](https://github.com/MultiMote/niimblue/wiki/Running-own-instance-with-Docker).
|
||||
|
||||
## Translations (click to contribute)
|
||||
|
||||
[](https://weblate.mmote.ru/engage/niimblue/)
|
||||
|
||||
## Other
|
||||
|
||||
| Links | |
|
||||
|--------| -- |
|
||||
| [<img src="https://github.com/user-attachments/assets/6b71007d-d4c4-41b2-be4a-64614f6ce250" width="48">](https://boosty.to/multimote) | Boosty (support project) |
|
||||
| [<img src="https://raw.githubusercontent.com/tandpfun/skill-icons/65dea6c4eaca7da319e552c09f4cf5a9a8dab2c8/icons/Discord.svg" width="48">](https://discord.gg/jXPAfZVd8a) | Discord (dev news, troubleshooting and other, en) |
|
||||
| [<img src="https://github.com/user-attachments/assets/4d9f6e59-d751-40a4-ad6a-74a7541ff4cc" width="48">](https://t.me/niimblue) | Telegram (ru/en discussion) |
|
||||
|
||||
|
||||
BIN
about/batch.png
|
Before Width: | Height: | Size: 73 KiB After Width: | Height: | Size: 75 KiB |
BIN
about/dither.png
|
Before Width: | Height: | Size: 95 KiB After Width: | Height: | Size: 55 KiB |
BIN
about/labels.png
|
Before Width: | Height: | Size: 40 KiB After Width: | Height: | Size: 54 KiB |
7
about/logo.svg
Normal file
@@ -0,0 +1,7 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<svg width="270" height="84" version="1.1" viewBox="0 0 71.438 22.225" xmlns="http://www.w3.org/2000/svg">
|
||||
<g transform="matrix(.24321 0 0 .24321 -2.8907 -9.5)" stroke-width=".765" aria-label="NiimBlue">
|
||||
<path d="m65.118 108.48h-12.895l-20.815-36.197h-0.29456q0.13091 2.2582 0.2291 4.5492t0.19637 4.582q0.09818 2.2583 0.19637 4.5492v22.517h-9.0657v-47.849h12.797l20.782 35.837h0.2291q-0.06546-2.2255-0.16364-4.4183-0.09819-2.1928-0.19637-4.3856-0.06546-2.1928-0.13091-4.3856v-22.648h9.1312zm17.055-36.59v36.59h-9.9821v-36.59zm-4.9747-14.335q2.2255 0 3.8292 1.0473 1.6037 1.0146 1.6037 3.8292 0 2.7819-1.6037 3.8619-1.6037 1.0473-3.8292 1.0473-2.2583 0-3.8619-1.0473-1.571-1.08-1.571-3.8619 0-2.8146 1.571-3.8292 1.6037-1.0473 3.8619-1.0473zm21.244 14.335v36.59h-9.9821v-36.59zm-4.9747-14.335q2.2255 0 3.8292 1.0473 1.6037 1.0146 1.6037 3.8292 0 2.7819-1.6037 3.8619-1.6037 1.0473-3.8292 1.0473-2.2583 0-3.8619-1.0473-1.571-1.08-1.571-3.8619 0-2.8146 1.571-3.8292 1.6037-1.0473 3.8619-1.0473zm54.234 13.648q6.2184 0 9.393 3.2074 3.2074 3.1746 3.2074 10.211v23.859h-10.015v-21.372q0-3.9274-1.3418-5.9238-1.3419-1.9964-4.1565-1.9964-3.9601 0-5.6293 2.8474-1.6691 2.8146-1.6691 8.0839v18.361h-9.9821v-21.372q0-2.6183-0.58911-4.3856t-1.8-2.651q-1.211-0.88366-3.1092-0.88366-2.7819 0-4.3856 1.4073-1.571 1.3746-2.2582 4.091-0.65456 2.6837-0.65456 6.5784v17.215h-9.9821v-36.59h7.6257l1.3419 4.6801h0.55638q1.1128-1.8982 2.7819-3.0765 1.7019-1.1782 3.731-1.7346 2.0292-0.55638 4.1238-0.55638 4.0256 0 6.8075 1.3091 2.8146 1.3091 4.3201 4.0583h0.88366q1.6364-2.8146 4.6147-4.091 3.011-1.2764 6.1856-1.2764z" fill="#ff5349" style="paint-order:stroke fill markers"/>
|
||||
<path d="m167.15 60.63h14.891q9.5567 0 14.466 2.6837t4.9092 9.4257q0 2.7164-0.88367 4.9092-0.85093 2.1928-2.4873 3.6001-1.6364 1.4073-3.9928 1.8328v0.32728q2.3892 0.49092 4.3201 1.7019 1.931 1.1782 3.0765 3.4692 1.1782 2.2583 1.1782 6.022 0 4.3529-2.1273 7.462-2.1273 3.1092-6.0875 4.7783-3.9274 1.6364-9.3603 1.6364h-17.902zm10.146 18.95h5.8911q4.4183 0 6.1202-1.3746 1.7019-1.4073 1.7019-4.1238 0-2.7492-2.0292-3.9274-1.9964-1.2109-6.3493-1.2109h-5.3347zm0 8.0512v12.469h6.6111q4.582 0 6.382-1.7673t1.8-4.7456q0-1.7673-0.78548-3.1092t-2.651-2.0946q-1.8328-0.75275-5.0729-0.75275zm39.899 20.848h-9.9821v-50.925h9.9821zm39.867-36.59v36.59h-7.6584l-1.3419-4.6801h-0.52365q-1.1782 1.8655-2.9456 3.0437-1.7673 1.1782-3.8947 1.7346t-4.4183 0.55638q-3.9274 0-6.8402-1.3746-2.9128-1.4073-4.5492-4.3529-1.6037-2.9455-1.6037-7.6584v-23.859h9.9821v21.372q0 3.9274 1.4073 5.9238t4.4838 1.9964q3.0437 0 4.7783-1.3746 1.7346-1.4073 2.4219-4.091 0.72002-2.7164 0.72002-6.6111v-17.215zm21.375-0.68729q5.0729 0 8.7384 1.9637 3.6656 1.931 5.662 5.6293t1.9964 9.033v4.8438h-23.597q0.16365 4.2219 2.5201 6.6438 2.3892 2.3892 6.6111 2.3892 3.5019 0 6.4147-0.72002t5.9893-2.1601v7.7239q-2.7164 1.3418-5.6947 1.9637-2.9456 0.62184-7.1675 0.62184-5.4984 0-9.753-2.0292-4.222-2.0292-6.6438-6.1856-2.3892-4.1565-2.3892-10.473 0-6.4147 2.1601-10.669 2.1928-4.2874 6.0875-6.4147 3.8947-2.1601 9.0657-2.1601zm0.0655 7.102q-2.9128 0-4.8438 1.8655-1.8982 1.8655-2.1928 5.8584h14.008q-0.0327-2.2255-0.81821-3.9601-0.75275-1.7346-2.291-2.7492-1.5055-1.0146-3.8619-1.0146z" fill="#0b7eff" style="paint-order:stroke fill markers"/>
|
||||
</g>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 3.2 KiB |
|
Before Width: | Height: | Size: 32 KiB After Width: | Height: | Size: 33 KiB |
BIN
about/save_load.png
Normal file
|
After Width: | Height: | Size: 47 KiB |
|
Before Width: | Height: | Size: 24 KiB After Width: | Height: | Size: 20 KiB |
BIN
about/ui.png
|
Before Width: | Height: | Size: 75 KiB After Width: | Height: | Size: 87 KiB |