xpipe/README.md

97 lines
5.8 KiB
Markdown
Raw Normal View History

2023-04-12 09:20:09 +12:00
<img src="https://user-images.githubusercontent.com/72509152/213873342-7638e830-8a95-4b5d-ad3e-5a9a0b4bf538.png" alt="drawing" width="250"/>
2022-08-13 19:29:26 +12:00
2023-06-04 11:17:27 +12:00
### The remote file browser for professionals
2023-04-17 11:06:59 +12:00
2023-06-03 05:44:55 +12:00
XPipe is a brand-new type of remote file browser that works by interacting with your installed command-line programs to establish and utilize local and remote shell connections. This approach makes it much more flexible as it doesn't have to deal with any file system APIs, remote file handling protocols, or libraries at all.
2023-04-17 11:06:59 +12:00
2023-06-04 11:17:27 +12:00
It comes with all file management features you would expect plus a dedicated remote connection manager to organize and open remote shell connections to your infrastructure.
XPipe fully integrates with your existing tools by delegating all tasks to your favourite text/code editors, terminals, shells, command-line tools and more. The platform is designed to be extensible, allowing anyone to add easily support for more tools or to implement custom functionality through a modular extension system.
The full feature set is currently supported for:
2023-06-02 20:42:34 +12:00
- Containers located on any host such as [docker](https://www.docker.com/) or [LXD](https://linuxcontainers.org/lxd/introduction/) container instances
2023-04-17 11:06:59 +12:00
- [SSH](https://www.ssh.com/academy/ssh/protocol) connections
2023-06-02 20:42:34 +12:00
- [Windows Subsystem for Linux](https://ubuntu.com/wsl) instances
2023-04-17 11:06:59 +12:00
- [Powershell Remote Sessions](https://learn.microsoft.com/en-us/powershell/scripting/learn/remoting/running-remote-commands?view=powershell-7.3)
2023-06-02 20:42:34 +12:00
- [Kubernetes](https://kubernetes.io/) clusters and their contained pods and containers
2023-04-17 11:06:59 +12:00
- Any other custom remote connection methods that works through the command-line
- Arbitrary types of proxies to establish connections
2023-06-04 11:17:27 +12:00
The project is still in a relatively early stage and will benefit massively from your feedback, issue reports, feature request, and more. There are also a lot more features to come in the future.
2023-01-27 15:34:46 +13:00
2023-05-01 19:06:35 +12:00
You have more questions? Then check out the new [FAQ](/FAQ.md).
2023-06-03 04:44:41 +12:00
## Downloads
2023-03-29 00:43:55 +13:00
2023-06-03 04:44:41 +12:00
### Installers
2023-06-03 05:44:55 +12:00
Installers are the easiest way to get started and come with an optional automatic update functionality. The following installers are available:
2023-06-03 04:44:41 +12:00
2023-06-03 05:44:55 +12:00
- [Windows .msi Installer (x86-64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-installer-windows-x86_64.msi)
- [Linux .deb Installer (x86-64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-installer-linux-x86_64.deb)
- [Linux .rpm Installer (x86-64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-installer-linux-x86_64.rpm)
- [MacOS .pkg Installer (x86-64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-installer-macos-x86_64.pkg)
- [MacOS .pkg Installer (ARM 64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-installer-macos-arm64.pkg)
2023-06-03 04:44:41 +12:00
### Portable
If you don't like installers, you can also use portable versions that are packaged as an archive. The following portable versions are available:
2023-06-03 05:44:55 +12:00
- [Windows .zip Portable (x86-64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-portable-windows-x86_64.zip)
- [Linux .tar.gz Portable (x86-64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-portable-linux-x86_64.tar.gz)
- [MacOS .dmg Portable (x86-64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-portable-macos-x86_64.dmg)
- [MacOS .dmg Portable (ARM 64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-portable-macos-arm64.dmg)
2023-06-03 04:44:41 +12:00
2023-06-03 05:44:55 +12:00
### Install Script (Linux / MacOS)
2023-06-03 04:44:41 +12:00
You can also install XPipe by pasting the installation command into your terminal. This will perform the full setup automatically.
```
bash <(curl -sL https://raw.githubusercontent.com/xpipe-io/xpipe/master/get-xpipe.sh)
```
2023-03-29 00:43:55 +13:00
## Features
2023-06-05 03:04:14 +12:00
### Powerful remote file browser
2023-01-27 15:34:46 +13:00
2023-06-02 20:42:34 +12:00
- Interact with the file system of any remote system using a workflow optimized for professionals
2023-03-29 00:56:11 +13:00
- Quickly open a terminal into any directory
- Utilize your favourite local programs to open and edit remote files
2023-06-03 05:44:55 +12:00
- Has the same feature set for all supported connection types
2023-06-04 11:17:27 +12:00
- Dynamically elevate sessions with sudo when required
2023-01-27 15:34:46 +13:00
2023-04-17 11:10:59 +12:00
![Remote file explorer](https://user-images.githubusercontent.com/72509152/230100929-4476f76c-ea81-43d9-ac4a-b3b02df2334e.png)
2023-04-11 03:47:17 +12:00
2023-06-02 20:42:34 +12:00
### Simple connection management
2023-01-27 15:34:46 +13:00
2023-06-02 20:42:34 +12:00
- Easily create and manage all kinds of remote connections
2023-04-17 11:06:59 +12:00
- Securely stores all information exclusively on your computer and encrypts all secret information. See
2023-06-02 20:42:34 +12:00
the [security page](/SECURITY.md) for more information
- Create custom desktop shortcuts to automatically open specific remote connections in your terminal
2023-06-05 03:04:14 +12:00
- Don't worry about encoding issues on Windows systems, all shells are launched in UTF8 mode by default
2023-01-27 15:34:46 +13:00
2023-04-17 11:14:20 +12:00
![Connection manager](https://user-images.githubusercontent.com/72509152/230098966-000596ca-8167-4cb8-8ada-f6b3a7d482e2.png)
2023-01-27 15:34:46 +13:00
2023-03-29 00:56:11 +13:00
### Instant launch for remote shells and commands
- Automatically login into a shell in your favourite terminal with one click (no need to fill password prompts, etc.)
2023-06-03 05:44:55 +12:00
- Works for all kinds of shells and connections, locally and remote.
- Supports command shells (e.g. bash, PowerShell, cmd, etc.) and some database shells (e.g. PostgreSQL Shell)
2023-06-02 20:42:34 +12:00
- Comes with support for all commonly used terminals across all operating systems
2023-06-03 05:44:55 +12:00
- Allows you to fully customize the init environment of the launched shell session with custom scripts
2023-06-02 20:42:34 +12:00
- Supports launches from the GUI or command-line
2023-02-27 18:38:36 +13:00
2023-04-17 11:06:59 +12:00
## Further information
2023-02-09 10:34:19 +13:00
2023-05-21 02:23:36 +12:00
For information about the security model of XPipe, see the [security page](/SECURITY.md).
2022-06-18 10:29:41 +12:00
2023-05-21 02:23:36 +12:00
For information about the privacy policy of XPipe, see the [privacy page](/PRIVACY.md).
2023-04-22 01:04:19 +12:00
2023-06-02 20:42:34 +12:00
In case you're interested in development, check out the [development page](/DEVELOPMENT.md).
2023-04-17 11:06:59 +12:00
If you want to talk you can also join:
2022-06-18 10:29:41 +12:00
2023-05-21 02:23:36 +12:00
- The [XPipe Discord Server](https://discord.gg/8y89vS8cRb)
- The [XPipe Slack Server](https://join.slack.com/t/XPipe/shared_invite/zt-1awjq0t5j-5i4UjNJfNe1VN4b_auu6Cg)
2023-06-04 11:17:27 +12:00