~ Basically, WinSCP on a terminal ~
Developed by Christian Visintin
Current version: 0.1.0 (06/12/2020)
TermSCP is basically a porting of WinSCP to terminal. So basically is a terminal utility with an TUI to connect to a remote server to retrieve and upload files and to interact with the local file system. It works both on Linux, MacOS, UNIX and Windows and supports SFTP, SCP, FTP and FTPS.
It happens very often to me, when using SCP at work to forget the path of a file on a remote machine, which forces me then to connect through SSH, gather the file path and finally download it through SCP. I could use WinSCP, but I use Linux and I pratically use the terminal for everything, so I wanted something like WinSCP on my terminal. Yeah, I know there midnight commander too, but actually I don't like it very much tbh (and doesn't support scp).
If you're considering to install TermSCP I want to thank you ๐ ! I hope you will enjoy TermSCP!
If you want to contribute to this project, don't forget to check out our contribute guide. Read More
```sh
cargo install termscp ```
Get deb package from HERE
or run wget https://github.com/ChristianVisintin/TermSCP/releases/download/latest/termscp_0.1.0_amd64.deb
then install through dpkg:
```sh dpkg -i termscp_*.deb
gdebi termscp_*.deb ```
Get rpm package from HERE
or run wget https://github.com/ChristianVisintin/TermSCP/releases/download/latest/termscp-0.1.0-1.x86_64.rpm
then install through rpm:
sh
rpm -U termscp_*.rpm
You can install TermSCP on Windows using chocolatey
Start PowerShell as administrator and run
ps
choco install termscp
Alternatively you can download the ZIP file from HERE
and then with PowerShell started with administrator previleges, run:
ps
choco install termscp -s .
You can install TermSCP on MacOS using brew
From your terminal run
sh
brew tap ChristianVisintin/termscp
brew install termscp
TermSCP can be started with the following options:
-P, --password <password> if address is provided, password will be this argument-v, --version Print version info-h, --help Print help pageTermSCP can be started in two different mode, if no extra arguments is provided, TermSCP will show the authentication form, where the user will be able to provide the parameters required to connect to the remote peer.
Alternatively, the user can provide an address as argument to skip the authentication form and starting directly the connection to the remote server.
The address argument has the following syntax:
txt
Let's see some example of this particular syntax, since it's very comfortable and you'll probably going to use this instead of the other one...
Connect using default protocol (sftp) to 192.168.1.31, port is default for this protocol (22); username is current user's name
sh
termscp 192.168.1.31
Connect using default protocol (sftp) to 192.168.1.31, port is default for this protocol (22); username is root
sh
termscp root@192.168.1.31
Connect using scp to 192.168.1.31, port is 4022; username is omar
sh
termscp scp://omar@192.168.1.31:4022
You have probably noticed, that, when providing the address as argument, there's no way to provide the password. Password can be basically provided through 3 ways when address argument is provided:
-P, --password option: just use this CLI option providing the password. I strongly unrecommend this method, since it's very unsecure (since you might keep the password in the shell history)sshpass: you can provide password via sshpass, e.g. sshpass -f ~/.ssh/topsecret.key termscp cvisintin@192.168.1.31scp, ssh, etc.| Key | Command |
|---------------|-------------------------------------------------------|
| <ESC> | Disconnect from remote; return to authentication page |
| <TAB> | Switch between log tab and explorer |
| <BACKSPACE> | Go to previous directory in stack |
| <RIGHT> | Move to remote explorer tab |
| <LEFT> | Move to local explorer tab |
| <UP> | Move up in selected list |
| <DOWN> | Move down in selected list |
| <PGUP> | Move up in selected list by 8 rows |
| <PGDOWN> | Move down in selected list by 8 rows |
| <ENTER> | Enter directory |
| <SPACE> | Upload / download selected file |
| <CTRL+D> | Make directory |
| <CTRL+G> | Go to supplied path |
| <CTRL+H> | Show help |
| <CTRL+Q> | Quit TermSCP |
| <CTRL+R> | Rename file |
| <CTRL+U> | Go to parent directory |
| <CANC> | Delete file |
The developer documentation can be found on Rust Docs at https://docs.rs/termscp
1 Jan 1970, but shouldn't be: that's because chrono can't parse date in a different locale. So if your server has a locale different from the one on your machine, it won't be able to parse the date.vsftpd is the only one server which I saw working correctly with TermSCP. Am I going to solve this? I'd like to, but it's not my fault at all. Unfortunately rust-ftp is an abandoned project (up to 2020), indeed I had to patch many stuff by myself. I'll try to solve these issues, but it will take a long time.Contributions are welcome! ๐
If you think you can contribute to TermSCP, please follow TermSCP's contributions guide
View TermSCP's changelog HERE
TermSCP is powered by these aweseome projects:
Licensed under the GNU GPLv3 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.gnu.org/licenses/gpl-3.0.txt
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
You can read the entire license HERE