Go to file
2020-12-06 22:09:22 +01:00
.github GIFs and templates 2020-12-06 22:09:22 +01:00
assets/images GIFs and templates 2020-12-06 22:09:22 +01:00
dist Dist deb, rpm 2020-12-06 12:32:53 +01:00
docs/drawio Working on AuthActivity 2020-11-21 21:26:27 +01:00
src Wtf? %M:%H format? 2020-12-06 21:24:53 +01:00
.gitignore Dist deb, rpm 2020-12-06 12:32:53 +01:00
Cargo.lock Write current path on explorer tabs 2020-12-05 16:32:16 +01:00
Cargo.toml Dist deb, rpm 2020-12-06 12:32:53 +01:00
CHANGELOG.md CHANGELOG 2020-12-06 15:07:52 +01:00
CODE_OF_CONDUCT.md Project initialized 2020-11-07 17:48:41 +01:00
CONTRIBUTING.md Start writing CONTRIBUTING guide 2020-12-05 15:20:48 +01:00
LICENSE Project initialized 2020-11-07 17:48:41 +01:00
README.md choco 2020-12-06 14:38:22 +01:00

TermSCP

License: GPL v3 Stars Issues Downloads Crates.io Docs

Build Build Build

~ Basically, WinSCP on a terminal ~
Developed by Christian Visintin
Current version: 0.1.0 (06/12/2020)



About TermSCP 🖥

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.

Why TermSCP 🤔

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).

Features 🎁

  • Different communication protocols
    • SFTP
    • SCP
    • FTP and FTPS
  • Practical user interface to explore and operate on the remote and on the local machine file system
  • Compatible with Windows, Linux, UNIX and MacOS
  • Written in Rust
  • Easy to extend with new file transfers protocols

Usage

TermSCP can be started with the following options:

  • -v, --version Print version info
  • -h, --help Print help page

Installation ▶

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

Cargo 🦀

# Install termscp through cargo
cargo install termscp

Deb package 📦

Get deb package from HERE or run wget https://github.com/ChristianVisintin/TermSCP/releases/download/v0.1.0/termscp_0.1.0_amd64.deb

then install through dpkg:

dpkg -i termscp_*.deb
# Or even better with gdebi
gdebi termscp_*.deb

RPM Package 📦

Get rpm package from HERE or run wget https://github.com/ChristianVisintin/TermSCP/releases/download/v0.1.0/termscp-0.1.0-1.x86_64.rpm

then install through rpm:

rpm -U termscp_*.rpm

Chocolatey 🍫

You can install TermSCP on Windows using chocolatey

Start PowerShell as administrator and run

choco install termscp

Alternatively you can download the ZIP file from HERE

and then with PowerShell started with administrator previleges, run:

choco install termscp -s .

Brew 🍻


Documentation 📚

The developer documentation can be found on Rust Docs at https://docs.rs/termscp


Known issues 🧻

  • Ftp:
    • Time in explorer is 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.

Upcoming Features 🧪

  • File viewer: possibility to show in a popup the file content from the explorer.

Contributions 🤙🏻

Contributions are welcome! 😉

If you think you can contribute to TermSCP, please follow TermSCP's contributions guide

Changelog

See the enire changelog HERE


License 📃

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