# tinypilot

**Repository Path**: mirrors_mtlynch/tinypilot

## Basic Information

- **Project Name**: tinypilot
- **Description**: Use your Raspberry Pi as a browser-based KVM.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-01-06
- **Last Updated**: 2026-02-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TinyPilot

[![License](http://img.shields.io/:license-mit-blue.svg?style=flat-square)](LICENSE)
[![Contributors](https://img.shields.io/github/contributors/tiny-pilot/tinypilot)](https://github.com/tiny-pilot/tinypilot/graphs/contributors)
[![CircleCI](https://circleci.com/gh/tiny-pilot/tinypilot.svg?style=svg)](https://circleci.com/gh/tiny-pilot/tinypilot)
[![Twitter](https://img.shields.io/twitter/follow/tinypilotkvm?label=Twitter&style=social)](https://twitter.com/tinypilotkvm)

## Overview

Turn your Raspberry Pi into a browser-based KVM.

[![TinyPilot demo](https://raw.githubusercontent.com/tiny-pilot/tinypilot/master/readme-assets/demo-800w.gif)](https://raw.githubusercontent.com/tiny-pilot/tinypilot/master/readme-assets/demo.gif)

<https://tinypilotkvm.com>

## Features

- Video capture (HDMI/DVI/VGA)
- Keyboard forwarding
- Mouse forwarding
- Fullscreen mode
- Paste text from clipboard

## Official builds

### [TinyPilot Voyager 3](https://tinypilotkvm.com/products/tinypilot-voyager-3)

[TinyPilot Voyager 3](https://tinypilotkvm.com/products/tinypilot-voyager-3) is TinyPilot’s latest professional-grade KVM over IP device, trusted by IT teams in small offices and Fortune 10 companies, with plug-and-play set up backed by a 12-month warranty and expert priority support.

[![Photo of TinyPilot Voyager 3](https://github.com/user-attachments/assets/4c90ca50-743c-4b29-b99c-2b777451f482)](https://tinypilotkvm.com/products/tinypilot-voyager-3)

**What you get:**

- Rugged [rack-mountable design](https://tinypilotkvm.com/products/voyager-3-rack-shelf) with ultra-quiet active cooling
- Status screen with vital system information
- HDMI loop output provides video passthrough to a local monitor
- 1920x1200 video capture for better compatibility
- PoE option available for flexible deployment ([Voyager 3 Plus](https://tinypilotkvm.com/products/tinypilot-voyager-3?variant=46978111733952))
- Optional additional Ethernet interface ([Voyager 3 Plus](https://tinypilotkvm.com/products/tinypilot-voyager-3?variant=46978111733952))
- FCC/CE compliant
- [TinyPilot Pro software](https://tinypilotkvm.com/products/tinypilot-pro) included with lifetime updates
- 12-month extendable warranty
- Expert priority support

**[Shop Voyager 3 →](https://tinypilotkvm.com/products/tinypilot-voyager-3)**

## Build your own

Want to build your own device to run TinyPilot? You can assemble a DIY version using a Raspberry Pi 4b and a USB capture dongle. This is a great option for hobbyists and those on a tight budget.

- [Raspberry Pi 4B](https://smile.amazon.com/dp/B07TD42S27)
- [HDMI to USB dongle](https://smile.amazon.com/dp/B08CXWPYQ8/)
  - They have no brand name, and there are several variants, but they're all built on the same MacroSilicon 2109 chip.
  - They're available for \$10-15 on eBay and AliExpress.
- [3 Amp power supply](https://smile.amazon.com/dp/B0728HB18G)
- [USB-C to USB-A](https://smile.amazon.com/dp/B01GGKYN0A/) cable (Male/Male)
- [microSD card](https://smile.amazon.com/dp/B073K14CVB/) (Class 10, 8 GB or larger)
- [HDMI to HDMI cable](https://smile.amazon.com/dp/B014I8SSD0/)
  - Or \[other\] to HDMI, depending on how your target machine displays output.
- (Optional) [A USB-C OTG split connector](https://tinypilotkvm.com/products/tinypilot-power-connector): Supports continuous power when the target computer turns off.
  - Requires two additional [USB-A to microUSB cables](https://smile.amazon.com/dp/B01JPDTZXK/) and a [3 Amp power adapter](https://smile.amazon.com/dp/B0728HB18G).
  - If you're using this split connector, choose a USB-C to USB-A cable that's [12" or shorter](https://smile.amazon.com/dp/B012V56D2A/) to minimize voltage drop along the cable.
- (Optional) [VGA to HDMI Adapter](https://smile.amazon.com/dp/B07121Y1Z3/) - If your target system has VGA output.
  - Alternatively, you can replace the VGA to HDMI adapter and HDMI to USB dongle with a [VGA to USB adapter](https://smile.amazon.com/dp/B08GYXZC3D).

See ["TinyPilot: Build a KVM Over IP for Under \$100"](https://mtlynch.io/tinypilot/#how-to-build-your-own-tinypilot) for a more detailed tutorial on how to assemble these parts to create a TinyPilot.

## Simple installation

### Requirements

- A Raspberry Pi 4B running Raspberry Pi OS Bullseye (32-bit)

You can install TinyPilot on a compatible Raspberry Pi in just two commands.

```bash
curl \
  --silent \
  --show-error \
  https://raw.githubusercontent.com/tiny-pilot/tinypilot/master/get-tinypilot.sh | \
    bash - && \
  sudo reboot
```

When your Pi reboots, you should be able to access TinyPilot by visiting your Pi hostname in the browser. For example, if your device is named `raspberrypi`:

- [http://raspberrypi/](http://raspberrypi/)

If you're using an [HDMI to CSI capture chip](https://github.com/tiny-pilot/tinypilot/wiki/HDMI-Capture-Devices#toshiba-tc358743-capture-devices) (such as with a TinyPilot Voyager series device), see [the additional configuration steps](https://github.com/tiny-pilot/tinypilot/wiki/Installation-Options#example-tc358743-hdmi-to-csi-capture-chip) required for video capture.

## Developer installation

See the [CONTRIBUTING](CONTRIBUTING.md) file.

## Other installation options

- [Advanced installation options](https://github.com/tiny-pilot/tinypilot/wiki/Installation-Options#advanced-installation)

## Diagnostics

If you're having trouble with TinyPilot, you can retrive logs from the web dashboard by clicking "Logs" in the bottom of the main dashboard.

If you can't access the web dashboard, you can retrieve the logs by SSHing into the device and running the following command:

```bash
sudo /opt/tinypilot-privileged/scripts/collect-debug-logs
```

This log is useful if you [file a bug report](https://github.com/tiny-pilot/tinypilot/issues/new?assignees=&labels=&template=bug_report.md&title=).

You can read more details about the logs [in the wiki](https://github.com/tiny-pilot/tinypilot/wiki/Troubleshooting-and-Diagnostics).

## See also

- [TinyPilot Wiki](https://github.com/tiny-pilot/tinypilot/wiki): Guides for tasks related to TinyPilot.

## Acknowledgments

TinyPilot would not be possible without the excellent and generous work from many open source projects, the most notable of which are listed below:

- [uStreamer](https://github.com/pikvm/ustreamer)
- [Flask](https://github.com/pallets/flask) and [Flask-SocketIO](https://flask-socketio.readthedocs.io/en/latest/)
- [vdesktop](https://github.com/Botspot/vdesktop)
- [litestream](https://litestream.io)
- [Raspberry Pi](https://www.raspberrypi.org/)
- [nginx](https://nginx.org/)

## Mailing list

For news about major TinyPilot releases and other updates about the project, sign up for the TinyPilot mailing list:

- [TinyPilot Mailing List](https://tinypilotkvm.com/pages/about)

## Upgrade to Pro

TinyPilot Pro includes additional features for professional users, including:

- [Boot into a virtual disk drive](https://tinypilotkvm.com/blogs/news/tinypilot-adds-virtual-storage-bandwidth-tuning#boot-into-a-virtual-disk-drive)
- [Load virtual disk drive from URL](https://tinypilotkvm.com/blogs/news/whats-new-in-1-5-1#load-virtual-disk-drive-from-url)
- [Control TinyPilot programmatically](https://tinypilotkvm.com/blogs/news/tinypilots-july-release-improves-update-experience#control-tinypilot-programmatically)
- [Mount virtual media in CD-ROM mode](https://tinypilotkvm.com/blogs/news/whats-new-in-tinypilots-september-2021-update#mount-virtual-media-in-cd-rom-mode)
- [Wake on LAN](https://tinypilotkvm.com/blogs/news/whats-new-in-tinypilots-september-2021-update#wake-on-lan)
- [Manage SSH access from the web interface](https://tinypilotkvm.com/blogs/news/whats-new-in-2022-01#manage-ssh-access-from-the-web)
- [Assign a static IP address from the web interface](https://tinypilotkvm.com/blogs/news/tinypilot-static-ip-update-menu-improvements#assign-your-tinypilot-a-static-ip-address)
- [Easily transfer files using a virtual USB drive](https://tinypilotkvm.com/blogs/news/tinypilot-virtual-usb-file-transfer-touchscreen-support#easily-transfer-files-using-a-virtual-usb-drive)
- [Manage Wi-Fi connections from the web interface](https://tinypilotkvm.com/blogs/news/manage-wifi-and-network-status-tinypilot#manage-tinypilots-wi-fi-connection)
- [Execute scripts from the web interface](https://tinypilotkvm.com/blogs/news/whats-new-in-tinypilots-march-2025-update#execute-scripts-from-the-web-interface)
- [Save files to virtual media](https://tinypilotkvm.com/blogs/news/tinypilot-security-tailscale-user-roles#save-files-with-virtual-media)
- [User roles](https://tinypilotkvm.com/blogs/news/tinypilot-security-tailscale-user-roles#user-roles)
- [Tailscale integration](https://tinypilotkvm.com/blogs/news/tinypilot-security-tailscale-user-roles#connect-to-tailscale-in-seconds)

Support the project and upgrade to Pro at <https://tinypilotkvm.com/products/tinypilot-pro>.