Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bkniffler/zebra-printer
https://github.com/bkniffler/zebra-printer
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/bkniffler/zebra-printer
- Owner: bkniffler
- Created: 2019-01-17T17:23:59.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2019-01-17T18:52:21.000Z (almost 6 years ago)
- Last Synced: 2024-11-30T00:15:17.384Z (about 1 month ago)
- Language: C++
- Size: 290 KB
- Stars: 10
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
Awesome Lists containing this project
README
node-printer
============
Native bind printers on POSIX and Windows OS from Node.js, iojs and node-webkit.
Linux
Windows
Dependencies
If you have a problem, ask question to [](https://gitter.im/tojocky/node-printer?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) or find/create a new [Github issue](https://github.com/tojocky/node-printer/issues)
### Reason:
I was involved in a project where I need to print from Node.JS. This is the reason why I created this project and I want to share my code with others.
### Features:
* no dependecies;
* native method wrappers from Windows and POSIX (which uses [CUPS 1.4/MAC OS X 10.6](http://cups.org/)) APIs;
* compatible with node v0.8.x, 0.9.x and v0.11.x (with 0.11.9 and 0.11.13);
* compatible with node-webkit v0.8.x and 0.9.2;
* `getPrinters()` to enumerate all installed printers with current jobs and statuses;
* `getPrinter(printerName)` to get a specific/default printer info with current jobs and statuses;
* `getPrinterDriverOptions(printerName)` ([POSIX](http://en.wikipedia.org/wiki/POSIX) only) to get a specific/default printer driver options such as supported paper size and other info
* `getSelectedPaperSize(printerName)` ([POSIX](http://en.wikipedia.org/wiki/POSIX) only) to get a specific/default printer default paper size from its driver options
* `getDefaultPrinterName()` return the default printer name;
* `printDirect(options)` to send a job to a specific/default printer, now supports [CUPS options](http://www.cups.org/documentation.php/options.html) passed in the form of a JS object (see `cancelJob.js` example). To print a PDF from windows it is possible by using [node-pdfium module](https://github.com/tojocky/node-pdfium) to convert a PDF format into EMF and after to send to printer as EMF;
* `printFile(options)` ([POSIX](http://en.wikipedia.org/wiki/POSIX) only) to print a file;
* `getSupportedPrintFormats()` to get all possible print formats for printDirect method which depends on OS. `RAW` and `TEXT` are supported from all OS-es;
* `getJob(printerName, jobId)` to get a specific job info including job status;
* `setJob(printerName, jobId, command)` to send a command to a job (e.g. `'CANCEL'` to cancel the job);
* `getSupportedJobCommands()` to get supported job commands for setJob() depends on OS. `'CANCEL'` command is supported from all OS-es.
### How to install:
Make sure you have Python 2.x installed on your system. Windows users will also require Visual Studio (2013 Express is a good fit)
from [npmjs.org](https://www.npmjs.org/package/printer)
#### Prebuilt node builds
```
npm install printer --target_arch=ia32
npm install printer --target_arch=x64
```
#### Prebuilt electron builds
Say you are installing 1.4.5 electron. Please check the [Releases](https://github.com/tojocky/node-printer/releases) for supported Electron versions
```
npm install printer --runtime=electron --target=1.4.5 --target_arch=x64
npm install printer --runtime=electron --target=1.4.5 --target_arch=ia32
```
#### For building after install
```
npm install -g node-gyp
npm install printer --msvs_version=2013 --build-from-source=node_printer
```
or [direct from git](https://www.npmjs.org/doc/cli/npm-install.html):
npm install git+https://github.com/tojocky/node-printer.git
if you want to to run in [nwjs](http://nwjs.io/) then rebuild the module with [nw-gyp](https://github.com/nwjs/nw-gyp):
```
npm install -g nw-gyp
cd node_modules/printer
nw-gyp rebuild
```
For specific distribution `--dist-url` node-gyp parameter should be used. Example for electron:
```
node-gyp rebuild --target=0.37.4 --arch=x64 --dist-url=https://atom.io/download/atom-shell
```
Ubuntu User :
You need to install libcups2-dev package
`sudo apt-get install libcups2-dev`
### How to use:
See [examples](https://github.com/tojocky/node-printer/tree/master/examples)
### Author(s):
* Ion Lupascu, [email protected]
### Contibutors:
Feel free to download, test and propose new futures
### License:
[The MIT License (MIT)](http://opensource.org/licenses/MIT)