https://github.com/ostrolucky/stdinho
:electric_plug: Turn any STDIN/STDOUT into HTTP server
https://github.com/ostrolucky/stdinho
http-server stdin
Last synced: about 1 year ago
JSON representation
:electric_plug: Turn any STDIN/STDOUT into HTTP server
- Host: GitHub
- URL: https://github.com/ostrolucky/stdinho
- Owner: ostrolucky
- License: other
- Created: 2018-03-06T00:27:50.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2024-11-16T11:34:22.000Z (over 1 year ago)
- Last Synced: 2025-03-28T11:11:09.454Z (about 1 year ago)
- Topics: http-server, stdin
- Language: PHP
- Homepage:
- Size: 521 KB
- Stars: 134
- Watchers: 7
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-amphp - ostrolucky/stdinho - Turn any STDIN/STDOUT into HTTP server (Projects using amphp / Tunnel)
README
# stdinho
[![Latest Version on Packagist][ico-version]][link-packagist]
[![Software License][ico-license]](LICENSE.md)
[![Build Status][ico-build]][link-build]
`stdinho` is small command-line tool that creates TCP server, accepts any STDOUT as its STDIN and whoever connects to the server will get this data served as HTTP response.
It was written from frustration of having to share remote resources with my under-priviliged colleagues on semi-regular basis.
This typically involves downloading file, uploading file, sending the link, waiting until target finishes downloading file, deleting file.
In each stage of the process you would normally have to wait.
Diagram below compares the usual approach from above (having to wait in each stage) vs. streaming approach stdinho provides.
## Install
Via [Composer](https://getcomposer.org/doc/00-intro.md)
```bash
composer global require ostrolucky/stdinho
```
Or grab executable PHAR file from [Releases](https://github.com/ostrolucky/stdinho/releases)
## Usage
As simple as just piping some data in:
```bash
echo hello world|stdinho
```
For all options see
```bash
stdinho --help
```
## Features
* async. Yep, in PHP. No restriction on clients downloading simultaneusly
* buffers to temp file before client is connected, so no time or data in between is lost
* cross-platform: Linux/MacOS/Windows
* detects MIME type and attaches it to HTTP response
* neat progress bar showing status of buffering and client downloads.
## Examples
Video streaming
```bash
# Server
$ stdinho 0.0.0.0:1337 < /file/to/a/movie.mp4
# Client
$ firefox http://127.0.0.1:1337
```
Simple one-way chat
```bash
# Server
# Server (broadcaster)
$ { while read a; do echo $a; done }|bin/stdinho 127.0.0.1:1337
# Client
curl 127.0.0.1:1337
```
Tail application logs in realtime
```bash
# Server
$ tail -f project/var/log/*.log|stdinho 0.0.0.0:1337
# Client
$ curl 127.0.0.1:1337
# Bonus: gzip transfer encoding (server)
$ tail -f project/var/*.log|gzip -c|stdinho 0.0.0.0:1337 --http-headers='["Content-Type: text/plain", "Content-Encoding: gzip", "Transfer-Encoding: gzip"]'
```
Stream a folder, including compression
```bash
# Server
$ zip -qr - project|stdinho 0.0.0.0:1337 -f project.zip
# Client
$ curl 127.0.0.1:1337 -o project.zip # Saves it to project.zip
```
Dump remote database and stream it to different database on the fly via middle man
```bash
# Server
$ ssh admin@example.com "mysqldump -u root -ptoor database|gzip -c"|stdinho 0.0.0.0:1337 -f "$(date).sql.gz" # also saves the backup locally
# Client
$ curl 127.0.0.1:1337|gunzip|mysql -u root -ptoor database # Import it directly to local DB
```
Use case from GIF in this README
```bash
# There is bad connectivity between A (public server) and B (user connected to network via special VPN),
# but good connectivity between A and C (on same local network as A, but not public).
# However, B and C are behind NAT in separate networks, so there is no direct connection between them.
# Here D is introduced, which is public server having good connection to both C and B, but no connection to A.
# In final, download stream goes like this: A -> C -> D -> B which bypasses connection problem between A and B and NAT issue at the same time
# This problem is basically animation shown in introduction of this README.
# C:
$ ssh -NR \*:1337:localhost:1337 D #Reverse tunnel. Note: GatewayPorts cannot be set to "no" in D's sshd_config
$ curl http://A.com/big_file.tar.gz|stdinho 0.0.0.0:1337
# B:
$ curl D:1337 -o big_file.tar.gz
```
## Licensing
GPLv3 license. Please see [License File](LICENSE.md) for more information.
[ico-version]: https://img.shields.io/packagist/v/ostrolucky/stdinho.svg?style=flat-square
[ico-license]: https://img.shields.io/badge/license-GPL-brightgreen.svg?style=flat-square
[ico-build]: https://github.com/ostrolucky/stdinho/actions/workflows/continuous-integration.yml/badge.svg
[link-packagist]: https://packagist.org/packages/ostrolucky/stdinho
[link-build]: https://github.com/ostrolucky/stdinho/actions/workflows/continuous-integration.yml