diff --git a/README.md b/README.md index 51d2ab2..9e8f5d9 100644 --- a/README.md +++ b/README.md @@ -8,35 +8,20 @@ [![Build](https://github.com/veeso/termscp/workflows/Linux/badge.svg)](https://github.com/veeso/termscp/actions) [![Build](https://github.com/veeso/termscp/workflows/MacOS/badge.svg)](https://github.com/veeso/termscp/actions) [![Build](https://github.com/veeso/termscp/workflows/Windows/badge.svg)](https://github.com/veeso/termscp/actions) [![Coverage Status](https://coveralls.io/repos/github/veeso/termscp/badge.svg)](https://coveralls.io/github/veeso/termscp) -~ A feature rich terminal file transfer ~ +

~ A feature rich terminal file transfer ~

+

+ Website + ยท + Installation + ยท + User manual +

+ Developed by Christian Visintin Current version: 0.5.0 FIXME: (13/04/2021) --- -- [termscp](#termscp) - - [About termscp ๐Ÿ–ฅ](#about-termscp-) - - [Features ๐ŸŽ](#features-) - - [Get started ๐Ÿ](#get-started-) - - [Cargo ๐Ÿฆ€](#cargo-) - - [Deb package ๐Ÿ“ฆ](#deb-package-) - - [RPM package ๐Ÿ“ฆ](#rpm-package-) - - [AUR Package ๐Ÿ”ผ](#aur-package-) - - [Chocolatey ๐Ÿซ](#chocolatey-) - - [Brew ๐Ÿป](#brew-) - - [User Manual ๐ŸŽ“](#user-manual-) - - [Documentation ๐Ÿ“š](#documentation-) - - [Known issues ๐Ÿงป](#known-issues-) - - [Upcoming Features ๐Ÿงช](#upcoming-features-) - - [Contributing and issues ๐Ÿค๐Ÿป](#contributing-and-issues-) - - [Changelog โณ](#changelog-) - - [Powered by ๐Ÿš€](#powered-by-) - - [Gallery ๐ŸŽฌ](#gallery-) - - [Buy me a coffee โ˜•](#buy-me-a-coffee-) - - [License ๐Ÿ“ƒ](#license-) - ---- - ## About termscp ๐Ÿ–ฅ Termscp is a feature rich terminal file transfer and explorer, with support for SCP/SFTP/FTP. 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 is **Linux**, **MacOS**, **BSD** and **Windows** compatible and supports SFTP, SCP, FTP and FTPS. @@ -69,99 +54,20 @@ Termscp is a feature rich terminal file transfer and explorer, with support for --- -## Get started ๐Ÿ +## Get started ๐Ÿš€ 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](CONTRIBUTING.md) -You can opt for any of these methods, according to your systems and preferences: - -### Cargo ๐Ÿฆ€ - -```sh -# Install termscp via cargo -cargo install termscp -``` - -Requirements: - -- Linux - - pkg-config - - libssh2 - - openssl - -### Deb package ๐Ÿ“ฆ - -Get `deb` package from [HERE](https://github.com/veeso/termscp/releases/latest/download/termscp_0.5.0_amd64.deb) -or run `wget https://github.com/veeso/termscp/releases/latest/download/termscp_0.5.0_amd64.deb` - -then install via dpkg: - -```sh -dpkg -i termscp_*.deb -# Or even better with gdebi -gdebi termscp_*.deb -``` - -### RPM package ๐Ÿ“ฆ - -Get `rpm` package from [HERE](https://github.com/veeso/termscp/releases/latest/download/termscp-0.5.0-1.x86_64.rpm) -or run `wget https://github.com/veeso/termscp/releases/latest/download/termscp-0.5.0-1.x86_64.rpm` - -then install via rpm: - -```sh -rpm -U termscp_*.rpm -``` - -### AUR Package ๐Ÿ”ผ - -On Arch Linux based distribution, you can install termscp using for istance [yay](https://github.com/Jguer/yay), which I recommend to install AUR packages. - -```sh -yay -S termscp -``` - -### Chocolatey ๐Ÿซ - -You can install termscp on Windows via [chocolatey](https://community.chocolatey.org/packages/termscp) - -Start PowerShell as administrator and run - -```ps -choco install termscp -``` - -Alternatively you can download the ZIP file from [HERE](https://github.com/veeso/termscp/releases/latest/download/termscp.0.5.0.nupkg) - -and then with PowerShell started with administrator previleges, run: - -```ps -choco install termscp -s . -``` - -### Brew ๐Ÿป - -You can install termscp on MacOS using [brew](https://brew.sh/) - -From your terminal run - -```sh -brew install veeso/termscp/termscp -``` +Visit [termscp website](https://veeso.github.io/termscp/#get-started) to get started with termscp. --- -## User Manual ๐ŸŽ“ +## Buy me a coffee โ˜• -[Click here](docs/man.md) to read the user manual! +If you like termscp and you'd love to see the project to grow, please consider a little donation ๐Ÿฅณ -What you will find: - -- CLI options -- Keybindings -- Bookmarks -- Configuration +[![Buy-me-a-coffee](https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee&emoji=&slug=veeso&button_colour=404040&font_colour=ffffff&font_family=Comic&outline_colour=ffffff&coffee_colour=FFDD00)](https://www.buymeacoffee.com/veeso) --- @@ -206,7 +112,7 @@ View termscp's changelog [HERE](CHANGELOG.md) --- -## Powered by ๐Ÿš€ +## Powered by ๐Ÿ’ช termscp is powered by these aweseome projects: @@ -245,14 +151,6 @@ termscp is powered by these aweseome projects: --- -## Buy me a coffee โ˜• - -If you like termscp and you'd love to see the project to grow, please consider a little donation ๐Ÿฅณ - -[![Buy-me-a-coffee](https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee&emoji=&slug=veeso&button_colour=404040&font_colour=ffffff&font_family=Comic&outline_colour=ffffff&coffee_colour=FFDD00)](https://www.buymeacoffee.com/veeso) - ---- - ## License ๐Ÿ“ƒ termscp is licensed under the MIT license. diff --git a/docs/man.md b/docs/man.md index 7599ab5..aa49c00 100644 --- a/docs/man.md +++ b/docs/man.md @@ -1,24 +1,5 @@ # User manual ๐ŸŽ“ -- [User manual ๐ŸŽ“](#user-manual-) - - [Usage โ“](#usage-) - - [Address argument ๐ŸŒŽ](#address-argument-) - - [How Password can be provided ๐Ÿ”](#how-password-can-be-provided-) - - [File explorer ๐Ÿ“‚](#file-explorer-) - - [Keybindings โŒจ](#keybindings-) - - [Work on multiple files ๐Ÿฅท](#work-on-multiple-files-) - - [Synchronized browsing โฒ๏ธ](#synchronized-browsing-๏ธ) - - [Bookmarks โญ](#bookmarks-) - - [Are my passwords Safe ๐Ÿ˜ˆ](#are-my-passwords-safe-) - - [Configuration โš™๏ธ](#configuration-๏ธ) - - [SSH Key Storage ๐Ÿ”](#ssh-key-storage-) - - [File Explorer Format](#file-explorer-format) - - [Text Editor โœ](#text-editor-) - - [How do I configure the text editor ๐Ÿฆฅ](#how-do-i-configure-the-text-editor-) - - [Logging ๐Ÿฉบ](#logging-) - ---- - ## Usage โ“ termscp can be started with the following options: @@ -119,7 +100,7 @@ In order to change panel you need to type `` to move the remote explorer p | `` | Reload current directory's content / Clear selection | List | | `` | Select a file | Mark | | `` | Create new file with provided name | New | -| `` | Edit file; see [Text editor](#text-editor-) | Open | +| `` | Edit file; see Text editor | Open | | `` | Quit termscp | Quit | | `` | Rename file | Rename | | `` | Save file as... | Save | @@ -183,7 +164,7 @@ In order to create a new bookmark, just follow these steps: whenever you want to use the previously saved connection, just press `` to navigate to the bookmarks list and load the bookmark parameters into the form pressing ``. -![Bookmarks](assets/images/bookmarks.gif) +![Bookmarks](https://github.com/veeso/termscp/blob/main/assets/images/bookmarks.gif?raw=true) ### Are my passwords Safe ๐Ÿ˜ˆ