mirror of
https://github.com/veeso/termscp.git
synced 2025-12-07 09:36:00 -08:00
Build docs
This commit is contained in:
34
README.md
34
README.md
@@ -1,6 +1,6 @@
|
|||||||
# TermSCP
|
# TermSCP
|
||||||
|
|
||||||
[](https://www.gnu.org/licenses/gpl-3.0) [](https://crates.io/crates/termscp) [](https://github.com/ChristianVisintin/TermSCP) [](https://github.com/ChristianVisintin/TermSCP/issues) [](https://crates.io/crates/termscp) [](https://github.com/ChristianVisintin/TermSCP/actions)
|
[](https://www.gnu.org/licenses/gpl-3.0) [](https://github.com/ChristianVisintin/TermSCP) [](https://github.com/ChristianVisintin/TermSCP/issues) [](https://crates.io/crates/termscp) [](https://crates.io/crates/termscp) [](https://github.com/ChristianVisintin/TermSCP/actions)
|
||||||
|
|
||||||
~ Basically, WinSCP on a terminal ~
|
~ Basically, WinSCP on a terminal ~
|
||||||
Developed by Christian Visintin
|
Developed by Christian Visintin
|
||||||
@@ -15,6 +15,10 @@ Current version: 0.1.0 (??/??/2020)
|
|||||||
- [Why TermSCP](#why-termscp)
|
- [Why TermSCP](#why-termscp)
|
||||||
- [Features](#features)
|
- [Features](#features)
|
||||||
- [Installation](#installation)
|
- [Installation](#installation)
|
||||||
|
- [Requirements](#requirements)
|
||||||
|
- [Install OpenSSL on Windows](#install-openssl-on-windows)
|
||||||
|
- [Precompiled Binaries](#precompiled-binaries)
|
||||||
|
- [Vcpkg](#vcpkg)
|
||||||
- [Cargo](#cargo)
|
- [Cargo](#cargo)
|
||||||
- [Deb / Rpm](#deb--rpm)
|
- [Deb / Rpm](#deb--rpm)
|
||||||
- [Usage](#usage)
|
- [Usage](#usage)
|
||||||
@@ -29,7 +33,7 @@ Current version: 0.1.0 (??/??/2020)
|
|||||||
|
|
||||||
## About TermSCP
|
## About TermSCP
|
||||||
|
|
||||||
TermSCP is basically a porting of WinSCP to terminal. So basically is a terminal tool with an UI to connect to a remote server to retrieve and upload files. It works both on Linux, MacOS and Windows (TODO: double check) and supports SFTP and FTPS.
|
TermSCP is basically a porting of WinSCP to terminal. So basically is a terminal tool with an UI to connect to a remote server to retrieve and upload files. It works both on **Linux**, **MacOS**, **UNIX** and **Windows** too and supports SFTP, FTP and FTPS.
|
||||||
|
|
||||||
### Why TermSCP
|
### Why TermSCP
|
||||||
|
|
||||||
@@ -39,7 +43,7 @@ It happens very often to me when using SCP at work to forget the path of a file
|
|||||||
|
|
||||||
- Different communication protocols
|
- Different communication protocols
|
||||||
- SFTP
|
- SFTP
|
||||||
- FTPS
|
- FTP and FTPS
|
||||||
- Practical user interface to explore the remote machine file system and to select the files to upload and download
|
- Practical user interface to explore the remote machine file system and to select the files to upload and download
|
||||||
- Written in Rust
|
- Written in Rust
|
||||||
- Easy to extend with new protocols
|
- Easy to extend with new protocols
|
||||||
@@ -49,6 +53,27 @@ It happens very often to me when using SCP at work to forget the path of a file
|
|||||||
If you're considering to install TermSCP I want to thank you 💛 ! I hope this project can be useful for you!
|
If you're considering to install TermSCP I want to thank you 💛 ! I hope this project can be useful for you!
|
||||||
If you want to contribute to this project, don't forget to check out our contribute guide. [Read More](CONTRIBUTING.md)
|
If you want to contribute to this project, don't forget to check out our contribute guide. [Read More](CONTRIBUTING.md)
|
||||||
|
|
||||||
|
### Requirements
|
||||||
|
|
||||||
|
- OpenSSL: only if you want **FTPS** support
|
||||||
|
|
||||||
|
#### Install OpenSSL on Windows
|
||||||
|
|
||||||
|
To install OpenSSL on Windows you have basically two options:
|
||||||
|
|
||||||
|
##### Precompiled Binaries
|
||||||
|
|
||||||
|
Download the precompiled binaries from <http://slproweb.com/products/Win32OpenSSL.html> (Non light installation); install to system path and then add to your environmental variables `OPENSSL_DIR=path\to\the\installation\dir`
|
||||||
|
|
||||||
|
##### Vcpkg
|
||||||
|
|
||||||
|
You can use [vcpkg](https://github.com/Microsoft/vcpkg) to install OpenSSL and then run
|
||||||
|
|
||||||
|
```dos
|
||||||
|
vcpkg install openssl:x64-windows
|
||||||
|
set VCPKG_ROOT=PATH_TO_VCPKG_INSTALLATION
|
||||||
|
```
|
||||||
|
|
||||||
### Cargo
|
### Cargo
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
@@ -81,7 +106,8 @@ TODO:
|
|||||||
|
|
||||||
## Upcoming Features
|
## Upcoming Features
|
||||||
|
|
||||||
TODO:
|
- **File viewer**: possibility to show in a popup the file content from the explorer.
|
||||||
|
- **Replacement of OpenSSL**: OpenSSL is kinda an annoying stuff, especially for Windows. Unfortunately rust-ftp requires OpenSSL to build. I'm working on replacing it on [rust-fpt](https://github.com/ChristianVisintin/rust-ftp/tree/rust-tls). If you want to give me a hand, feel free to contribute.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user