How do I stream a video from one computer to another using Airpaste?

On the source machine, run `airpaste < movie.mp4`, and on the destination, run `airpaste | mplayer -`. This pipes the video data directly to mplayer for streaming playback, as shown in the README example for media sharing.

Airpaste vs scp for local file transfer: which is better?

Airpaste is faster for ad-hoc transfers with zero configuration, but scp offers encryption and more reliable error handling. Use Airpaste for quick, trusted network shares, and scp for secure or critical data transfers.

Can Airpaste work over the internet or between different Wi-Fi networks?

No, Airpaste relies on mDNS for automatic peer discovery, which is limited to local networks. For internet transfers, you'd need to manually configure network settings or use tools like SSH tunneling.

How to troubleshoot when Airpaste doesn't find another peer on the network?

Ensure both machines are on the same local network, mDNS is enabled (common in home networks), and no firewalls are blocking multicast traffic. Try using a namespace to avoid conflicts with other instances.

Is Airpaste secure enough for sharing passwords or private documents?

Not recommended, as Airpaste transmits data without encryption. Only use it on trusted networks for non-sensitive data, as per the security note in the README warning about potential capture.

How can I integrate Airpaste into a custom Node.js script for automated data transfers?

Require the module with `var airpaste = require('airpaste')`, create a stream with `airpaste()` or `airpaste('namespace')`, and pipe data to it. This allows programmatic control, as detailed in the API section.

airpaste — Zero-Config Network Pipe

Q: Airpaste vs scp for local file transfer: which is better?

Airpaste is faster for ad-hoc transfers with zero configuration, but scp offers encryption and more reliable error handling. Use Airpaste for quick, trusted network shares, and scp for secure or critical data transfers.

Q: Can Airpaste work over the internet or between different Wi-Fi networks?

No, Airpaste relies on mDNS for automatic peer discovery, which is limited to local networks. For internet transfers, you'd need to manually configure network settings or use tools like SSH tunneling.

Q: How to troubleshoot when Airpaste doesn't find another peer on the network?

Ensure both machines are on the same local network, mDNS is enabled (common in home networks), and no firewalls are blocking multicast traffic. Try using a namespace to avoid conflicts with other instances.

Q: Is Airpaste secure enough for sharing passwords or private documents?

Not recommended, as Airpaste transmits data without encryption. Only use it on trusted networks for non-sensitive data, as per the security note in the README warning about potential capture.

Q: How can I integrate Airpaste into a custom Node.js script for automated data transfers?

Require the module with `var airpaste = require('airpaste')`, create a stream with `airpaste()` or `airpaste('namespace')`, and pipe data to it. This allows programmatic control, as detailed in the API section.

What is airpaste?

Airpaste is a command-line utility that creates a direct network connection between two computers on the same local network. It automatically discovers peers using mDNS technology, allowing users to pipe data between machines without any manual network configuration. It solves the problem of quickly transferring files or streaming data between devices without needing to know IP addresses or set up complex networking.

Target Audience

Developers, sysadmins, and technical users who need to quickly transfer files or stream data between machines on the same local network without complex setup. Particularly useful for ad-hoc workflows, debugging, or temporary data sharing.

Value Proposition

Airpaste offers the simplest possible way to create network pipes between machines—zero configuration, automatic discovery, and familiar Unix pipe semantics. Unlike traditional file transfer methods, it requires no manual IP addressing, port forwarding, or complex setup, making it ideal for quick, temporary data transfers.

A 1-1 network pipe that auto discovers other peers using mdns

Use Cases

Best For

Quickly transferring files between computers on the same local network
Streaming media (videos, music) from one machine to another for playback
Ad-hoc data sharing during development or debugging sessions
Creating temporary network pipes for testing or prototyping
Sharing command output or logs between machines without manual network configuration
Simple peer-to-peer communication in trusted local network environments

Not Ideal For

Transferring sensitive or confidential data over untrusted networks, as Airpaste lacks encryption
Scenarios requiring broadcasting to multiple peers or group communication, since it's designed for 1-1 connections
Environments where mDNS is disabled or not supported, such as some corporate networks with strict firewall rules

Pros & Cons

Pros

Automatic Peer Discovery

Uses mDNS to automatically find other Airpaste instances on the same local network, eliminating the need for manual IP configuration, as highlighted in the README and description.

Zero Configuration Setup

Requires no network setup, ports, or IP addresses, making it ideal for quick ad-hoc transfers without complex networking knowledge, as stated in the key features.

Unix-like Simplicity

Operates with familiar pipe semantics, allowing data to be streamed between stdin/stdout, which integrates seamlessly with command-line workflows, following its minimalist philosophy.

Versatile Data Handling

Can transfer files by piping to/from stdin/stdout, stream media to players like mplayer, and be used programmatically via Node.js API, as shown in the usage and API sections.

Cons

No Data Encryption

Data is transmitted unencrypted over the network, posing a security risk for sensitive information, as explicitly cautioned in the README's security note for trusted networks only.

Local Network Limitation

Only works on the same local network with mDNS support, preventing use over the internet or in networks where mDNS is blocked, limiting its applicability.

Minimal Error Recovery

As a minimalist tool, it lacks features for handling network interruptions or data corruption, which could lead to failed transfers without built-in error feedback or resume capabilities.

Frequently Asked Questions

What is airpaste?

Target Audience

Value Proposition

Use Cases

Best For

Quickly transferring files between computers on the same local network
Streaming media (videos, music) from one machine to another for playback
Ad-hoc data sharing during development or debugging sessions
Creating temporary network pipes for testing or prototyping
Sharing command output or logs between machines without manual network configuration
Simple peer-to-peer communication in trusted local network environments

Not Ideal For

Transferring sensitive or confidential data over untrusted networks, as Airpaste lacks encryption
Scenarios requiring broadcasting to multiple peers or group communication, since it's designed for 1-1 connections
Environments where mDNS is disabled or not supported, such as some corporate networks with strict firewall rules

Pros & Cons

Pros

Automatic Peer Discovery

Uses mDNS to automatically find other Airpaste instances on the same local network, eliminating the need for manual IP configuration, as highlighted in the README and description.

Zero Configuration Setup

Requires no network setup, ports, or IP addresses, making it ideal for quick ad-hoc transfers without complex networking knowledge, as stated in the key features.

Unix-like Simplicity

Operates with familiar pipe semantics, allowing data to be streamed between stdin/stdout, which integrates seamlessly with command-line workflows, following its minimalist philosophy.

Versatile Data Handling

Can transfer files by piping to/from stdin/stdout, stream media to players like mplayer, and be used programmatically via Node.js API, as shown in the usage and API sections.

Cons

No Data Encryption

Data is transmitted unencrypted over the network, posing a security risk for sensitive information, as explicitly cautioned in the README's security note for trusted networks only.

Local Network Limitation

Only works on the same local network with mDNS support, preventing use over the internet or in networks where mDNS is blocked, limiting its applicability.

Minimal Error Recovery

As a minimalist tool, it lacks features for handling network interruptions or data corruption, which could lead to failed transfers without built-in error feedback or resume capabilities.

Frequently Asked Questions

airpaste

What is airpaste?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?

airpaste

What is airpaste?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?