disposable fileserver

npm install glance
50 downloads in the last week
52 downloads in the last month


Build Status

a quick disposable http server for static files


npm install -g glance


Run glance from within a directory and you are immediately serving the files from within that directory

If the directory being served has a .glance.json file within it, configuration will be read from that. Failing that, glance will look for a ~/.glance.json for directives. Failing that, glance will use defaults. Command line options will always override config file options.

command line options

glance [options]

  • --dir, -d <dir> serve <dir> instead of current directory
  • --help, -h print help screen with option listing
  • --indexing, -i serve a directory index when requested
  • --indices, -I comma-separated file names to use as indices
  • --nodot, -n hide dot files
  • --port, -p <port> open server on <port> rather than 61403
  • --version, -V print version information
  • --verbose, -v enable verbose mode, printing log to stdout

config format

Your config should be valid json in the following format (shown with defaults):

  "port": 61403,
  "indexing": false,
  "dir": "/whatever/dir/you/are/in",
  "verbose": false,
  "indices": [],
  "nodot": false

as a module

Alternatively, you can require('glance') and use it as a module within your own code. The glance module provides access to the Glance object as well as createGlance, a function to return a new glance object.

Some sample code might just look something like this:

var glance = require('glance'),
    http = require('http'),
// init a glance object with custom options (all totally optional)
    g = createGlance({
      dir: '../Files', // defaults to current working dir
      port: 86753, // defaults to 61403
      indices: [], // use these file names to provide indices
      indexing: true, // will provide a directory list when requested
      nodot: true, // will hide dot files from lists and will not serve them
      verbose: true // defaults to false

// pass requests to glance if you wanna
http.createServer(function (req, res) {
  if (/^\/static\//.test(req.url)) return g.serveRequest(req, res)
  // pretend i do other stuff here...

// or, use it to start a static file server

// listen for read events
g.on('read', function (req) {
  /* req object of format:
     { fullPath: 'requested path',
       ip: 'remote ip address',
       method: 'requested method',
       response: 'response object' }

// listen for error events
g.on('error', function (req) {
  // stop the glance server



npm loves you