Practical overview
When it fits
Use Filebazaar when you want a self-managed digital-download storefront connected to Lightning Charge, with configurable prices and file previews.
Who it is for
- Creators or sellers who want to offer downloadable files for Bitcoin or Lightning payments.
- Operators comfortable configuring Lightning Charge and running a server-based JavaScript application.
Documented uses
- List files from a directory in a browsable storefront.
- Set a default price and override it for specific files or nested directory listings.
- Add a file description and custom purchase-button text.
- Generate previews for supported image, audio, video and document formats, and display EXIF metadata.
Requirements & limits
- Lightning Charge must be set up separately and configured with a required charge token.
- A token secret is required for HMAC access tokens; the initialization command generates one.
- File prices can be set globally and overridden per file; configuration also supports descriptions and nested file paths.
- Preview generation uses additional system tools, including FFmpeg, GraphicsMagick, unoconv and node-canvas dependencies.
- The browsing interface is documented as working without JavaScript.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up a Filebazaar storefront
Install Filebazaar, configure its required credentials and start the server for a directory of files.
Before you start
- Lightning Charge set up, with a charge token available.
- Node.js/npm environment and the listed system dependencies: exiftool, ffmpeg, graphicsmagick, unoconv, libcairo2-dev, libjpeg8-dev, libpango1.0-dev, libgif-dev, build-essential and g++.
- A directory containing the files to sell.
Steps
Install Filebazaar globally with the command below.
npm install -g filebazaarCreate or enter the directory containing the files to sell, then run
filebazaar initto create_filebazaar.yaml.Edit the configuration to provide
charge_token;token_secretis generated by initialization. Set file pricing or other documented options as needed.Run
filebazaarfrom the configured working directory to start the server.
Expected outcome
A running Filebazaar web interface for browsing the configured files, connected to Lightning Charge.
Guide limitations
- The README does not detail the payment flow or describe deployment beyond the documented server configuration.
- The listed preview dependencies cover metadata extraction and preview generation; the README does not establish that previews are generated for every file format.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 14 October 2026
- Original website title
- ElementsProject/filebazaar · Official homepage title · retained in its source language

