Directory Serve

Directory Serve is a CLI tool for securely browsing, sending, and receiving files between computers, Android devices, and iOS devices on the same network.

Installation

This is a Node.js module available through the npm registry. Installation is done using the npm install command:

npm install --global directory-serve

Quick start

directory-serve /path/to/directory

Without a global installation:

npx directory-serve /path/to/directory

Share one file:

npx directory-serve /path/to/file.pdf

The command prints a local URL and QR code. Open the URL on a device connected to the same network.

Command reference

directory-serve <path> [options]

| Option | Default | Description | | --- | --- | --- | | -p, --port | 8989 | HTTP port used by the server. | | -u, --uploadFile | true | Enable or disable uploads. Use --uploadFile=false for read-only sharing. | | --username | none | Require HTTP Basic Authentication with this username. | | --password | none | Password used with --username. | | --delete | false | Allow clients to remove files and folders. | | --max-upload-mb | 100 | Maximum size of each uploaded file in megabytes. | | --allowed-types | all | Comma-separated upload extension allowlist without dots. | | --upload-rate-limit | 30 | Maximum upload requests per client per minute. | | --debug | false | Print additional diagnostic information. | | --help | — | Display command help. | | --version | — | Display the installed version. |

Boolean options accept forms such as --delete, --delete=true, and --uploadFile=false.

Command examples

Share the current directory:

npx directory-serve .

Use a different port:

npx directory-serve ~/Desktop --port 3000

Create a read-only share with uploads and deletion disabled:

npx directory-serve ~/Desktop --uploadFile=false

Allow clients to upload and delete content:

npx directory-serve ~/Desktop --uploadFile=true --delete=true

Require a username and password:

npx directory-serve ~/Desktop --username test --password 'a-strong-password'

Limit each uploaded file to 25 MB:

npx directory-serve ~/Desktop --max-upload-mb 25

Only accept images and PDF documents:

npx directory-serve ~/Desktop --allowed-types jpg,jpeg,png,webp,pdf

Limit each client to ten upload requests per minute:

npx directory-serve ~/Desktop --upload-rate-limit 10

Combine authentication and all upload safeguards:

npx directory-serve ~/Desktop \
  --username team \
  --password 'a-strong-password' \
  --max-upload-mb 50 \
  --allowed-types jpg,jpeg,png,pdf,zip \
  --upload-rate-limit 10

Enable diagnostics while using another port:

npx directory-serve ~/Desktop --port 3000 --debug=true

Display help or the installed version:

npx directory-serve --help
npx directory-serve --version

Browser features

• Search and filter the current directory.
• Sort items by name, modification date, size, or type.
• Switch between list and grid layouts.
• Upload multiple files with queue and progress feedback.
• View current-folder size, item count, and upload limit.
• Use light mode by default or manually switch to persistent dark mode.

For Developing

Prerequisites

1. Node (>=12.0)

git clone https://github.com/cube-root/directory-serve.git

npm install

npm run dev -- /path/to/directory

For Contributing

Contribution Guide

Screenshot

CLI

!screenshot

Client

!screenshot !screenshot

Client Auth

!screenshot