Narcoleptic's Patch Mangler

    TypeScript icon, indicating that this package has built-in type declarations

    1.4.2 • Public • Published


    A very lightweight promise based Node.js wrapper for the native Raspberry Pi Camera CLI tools.

    Note: This was written with the intent of NOT being a hand holding library, but rather just give you access to execute commands on the camera in a flexible way.

    Want to Contribute or Help Out?

    Feel free to head over to the GitHub page for Pi-Camera and submit comments, issues, pulls, and whatever else you'd like. I plan on adding features as I need them for my own projects so if something isn't happening fast enough for you why not fix it? (:


    // NPM 5
    npm install pi-camera
    // Older NPM versions
    npm install pi-camera --save

    Basic usage

    Raspistill (Image Capture)

    const PiCamera = require('pi-camera');
    const myCamera = new PiCamera({
      mode: 'photo',
      output: `${ __dirname }/test.jpg`,
      width: 640,
      height: 480,
      nopreview: true,
      .then((result) => {
        // Your picture was captured
      .catch((error) => {
         // Handle your error

    Raspivid (Video Capture)

    const PiCamera = require('pi-camera');
    const myCamera = new PiCamera({
      mode: 'video',
      output: `${ __dirname }/video.h264`,
      width: 1920,
      height: 1080,
      timeout: 5000, // Record for 5 seconds
      nopreview: true,
      .then((result) => {
        // Your video was captured
      .catch((error) => {
         // Handle your error

    Something worth considering is that the Camera module captures videos in a .h264 format, which is raw and uncompressed. Most players do not support this format so you might want to convert your files into something like .mp4. You can read more about it here.

    Flags and Options

    The Raspistill and Raspivid commands support a good number of parameters and options.

    Currently they're all stored in the same files, so you'll need to do your do diligence and make sure you're using the correct options and flags for what you're trying to do. A good list of them can be found here

    What's the difference between Flags and Options?

    Good question!

    Flags are portions of the Raspistill and Raspivid commands that are passed and require no additional input to fuction like so:

    # NOTE: Not a working command 
    raspistill --nopreview --raw --hflip --vflip

    Options are portions of the Raspistill and Raspivid commands that are passed and require additional input to fuction like so:

    # NOTE: Not a working command 
    raspistill --output some/path/here --width 1080 --height 720

    While the command line tools support many flags and options they're not all configured in this lib. If you discover one that you need but isn't supported, consider testing it, adding it and making a PR.


    npm i @guillaumearm/pi-camera

    DownloadsWeekly Downloads






    Unpacked Size

    8.43 kB

    Total Files


    Last publish


    • trapcodien