npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

printhub

v1.0.6

Published

A javascript plugin for Bluetooth & USB printers.

Downloads

420

Readme

PrintHub

npm version License: MIT

PrintHub

PrintHub is a JavaScript plugin for printing text using a Bluetooth or USB thermal printer. Demo: PrintHub Demo

Features

  1. Print text with various options like bold, underline, alignment, and text size.
  2. Print text in two columns.
  3. Print dashed lines.
  4. Print line breaks.
  5. Supports two paper sizes: "58mm" and "80mm".
  6. Supports connecting to Bluetooth thermal printers.
  7. Compatible with modern browsers such as Chrome, Firefox, and Edge.
  8. Node.js compatible.
  9. Supports usage via CDN.
  10. Supports usage via NPM.
  11. ES6 compatible.

Installation

Using NPM

npm install printhub

Import or require PrintHub into your project.

import PrintHub from "printhub";

or

const PrintHub = require("printhub");

Using CDN

<script src="https://cdn.jsdelivr.net/npm/[email protected]/lib/index.min.js"></script>

Usage

Creating a PrintHub Instance

You can create an instance of PrintHub with or without specifying the desired paper size. Supported paper sizes are "58" and "80". If the paper size is not specified, the default is "58".

  1. Creating a PrintHub instance with "80" paper size

    let printer = new PrintHub({
      paperSize: "80",
    });
  2. Creating a PrintHub instance with "58" paper size

    let printer = new PrintHub();

Selecting Printer Type

You can select the type of printer to use. Supported types are "bluetooth" and "usb". If the printer type is not specified, the default is "bluetooth".

  1. Selecting "bluetooth" printer type

    let printer = new PrintHub({
      printerType: "bluetooth",
    });
  2. Selecting "usb" printer type

    let printer = new PrintHub({
      printerType: "usb",
    });

Connecting to Printer and Printing Text

Use the connectToPrint method to connect to a Bluetooth printer and print text. You need to provide two callback functions: onReady and onFailed.

| Callback | Description | | ---------- | --------------------------------------------------------------------------------------------------------------------- | | onReady | Called when the printer connection is successful. You can use the print object passed to this callback to print text. | | onFailed | Called when the printer connection fails. You can use the message parameter to get the error message. |

How to Use PrintHub

  1. Connect to the printer and print text.

    printer.connectToPrint({
      onReady: async (print) => {
        await print.writeText("Hello, World!");
      },
      onFailed: (message) => {
        console.log(message);
      },
    });
  2. Print bold text.

    printer.connectToPrint({
      onReady: async (print) => {
        await print.writeText("Hello, World!", { bold: true });
      },
      onFailed: (message) => {
        console.log(message);
      },
    });
  3. Print underlined text.

    printer.connectToPrint({
      onReady: async (print) => {
        await print.writeText("Hello, World!", { underline: true });
      },
      onFailed: (message) => {
        console.log(message);
      },
    });
  4. Print text with alignment.

    printer.connectToPrint({
      onReady: async (print) => {
        await print.writeText("Hello, World!", { align: "center" });
      },
      onFailed: (message) => {
        console.log(message);
      },
    });
  5. Print text with a specific size.

    printer.connectToPrint({
      onReady: async (print) => {
        await print.writeText("Hello, World!", { size: "double" });
      },
      onFailed: (message) => {
        console.log(message);
      },
    });
  6. Print text in two columns.

    printer.connectToPrint({
      onReady: async (print) => {
        await print.writeTextWith2Column("Name", "John Doe");
      },
      onFailed: (message) => {
        console.log(message);
      },
    });
  7. Print dashed lines.

    printer.connectToPrint({
      onReady: async (print) => {
        await print.writeDashLine();
      },
      onFailed: (message) => {
        console.log(message);
      },
    });
  8. Print line breaks.

    printer.connectToPrint({
      onReady: async (print) => {
        await print.writeLineBreak();
      },
      onFailed: (message) => {
        console.log(message);
      },
    });
  9. Print text with multiple options.

    printer.connectToPrint({
      onReady: async (print) => {
        await print.writeText("Hello, World!", {
          bold: true,
          underline: true,
          align: "center",
          size: "double",
        });
      },
      onFailed: (message) => {
        console.log(message);
      },
    });
  10. Print text with multiple options in two columns.

    printer.connectToPrint({
      onReady: async (print) => {
        await print.writeTextWith2Column("Name", "John Doe", {
          bold: true,
          underline: true,
          align: "center",
          size: "double",
        });
      },
      onFailed: (message) => {
        console.log(message);
      },
    });

API

| Method | Description | | --------------------------------------------- | ----------------------------------------------------------------------- | | writeLineBreak({ count = 1 }) | Writes a line break. | | writeDashLine() | Writes a dashed line. | | writeTextWith2Column(text1, text2, options) | Writes text in two columns. | | writeText(text, options) | Writes text. | | connectToPrint({ onReady, onFailed }) | Connects to the printer and calls the onReady or onFailed callback. |

Options for writeText and writeTextWith2Column Methods

| Option | Description | Default | | ----------- | ---------------------------------------------------------------------- | -------- | | bold | Specifies whether the text is printed in bold. | false | | underline | Specifies whether the text is printed with an underline. | false | | align | Specifies text alignment. Supported values: "left", "center", "right". | left | | size | Specifies the text size. Supported values: "normal", "double". | normal |

Requirements for USB Printer

Windows

  1. Install Zadig.
  2. Connect the USB Printer to your computer.
  3. Open Zadig and select your USB Printer.
  4. Install the WinUSB driver for your USB Printer.
  5. Done.

Linux

  1. Connect the USB Printer to your computer.
  2. Open the terminal and run lsusb.
  3. Find your USB Printer and note the vendor id and product id.
  4. Run sudo modprobe usblp.
  5. Run sudo echo "ATTRS{idVendor}=="YOUR_VENDOR_ID", ATTRS{idProduct}=="YOUR_PRODUCT_ID", MODE="0666", GROUP="plugdev" > /etc/udev/rules.d/99-usb-printer.rules.
  6. Run sudo udevadm control --reload-rules.
  7. Run sudo udevadm trigger.
  8. Done.

macOS

  1. Connect the USB Printer to your computer.
  2. Open the terminal and run ls /dev/cu.*.
  3. Find your USB Printer and note the device name.
  4. Run `sudo chmod
  5. Run `sudo chown
  6. Done.

Browser Support

Desktop

| Browser | Version | Status | | ------- | ------- | ------ | | Chrome | 61 | ✔️ | | Firefox | No | ❌ | | Edge | 79 | ✔️ | | Safari | No | ❌ | | Opera | 48 | ✔️ |

Mobile

| Browser | Version | Status | | ------- | ------- | ------ | | Chrome | 61 | ✔️ | | Firefox | No | ❌ | | Safari | No | ❌ | | Opera | 45 | ✔️ | | Samsung | 8.0 | ✔️ | | WebView | No | ❌ |

Change Log

v1.0.6

  • Remove unused code

v1.0.5

  • Update paper size from "58mm" and "80mm" to "58" and "80"

v1.0.4

  • Added instructions for USB Printer on Windows, Linux, and macOS

v1.0.3

  • Fixed USB Printer not working