It, zh-CN
This commit is contained in:
veeso
parent
18a579a204
commit
fd2144f8e9
26
README.md
26
README.md
|
|
@ -17,7 +17,7 @@
|
|||
<a href="https://github.com/veeso/termscp"
|
||||
><img
|
||||
height="20"
|
||||
src="https://raw.githubusercontent.com/veeso/termscp/main/assets/images/flags/us.png"
|
||||
src="/assets/images/flags/us.png"
|
||||
alt="English"
|
||||
/></a>
|
||||
|
||||
|
|
@ -25,7 +25,7 @@
|
|||
href="https://github.com/veeso/termscp/blob/main/docs/de/README.md"
|
||||
><img
|
||||
height="20"
|
||||
src="https://raw.githubusercontent.com/veeso/termscp/main/assets/images/flags/de.png"
|
||||
src="/assets/images/flags/de.png"
|
||||
alt="Deutsch"
|
||||
/></a>
|
||||
|
||||
|
|
@ -33,7 +33,7 @@
|
|||
href="https://github.com/veeso/termscp/blob/main/docs/es/README.md"
|
||||
><img
|
||||
height="20"
|
||||
src="https://raw.githubusercontent.com/veeso/termscp/main/assets/images/flags/es.png"
|
||||
src="/assets/images/flags/es.png"
|
||||
alt="Español"
|
||||
/></a>
|
||||
|
||||
|
|
@ -41,7 +41,7 @@
|
|||
href="https://github.com/veeso/termscp/blob/main/docs/fr/README.md"
|
||||
><img
|
||||
height="20"
|
||||
src="https://raw.githubusercontent.com/veeso/termscp/main/assets/images/flags/fr.png"
|
||||
src="/assets/images/flags/fr.png"
|
||||
alt="Français"
|
||||
/></a>
|
||||
|
||||
|
|
@ -49,7 +49,7 @@
|
|||
href="https://github.com/veeso/termscp/blob/main/docs/it/README.md"
|
||||
><img
|
||||
height="20"
|
||||
src="https://raw.githubusercontent.com/veeso/termscp/main/assets/images/flags/it.png"
|
||||
src="/assets/images/flags/it.png"
|
||||
alt="Italiano"
|
||||
/></a>
|
||||
|
||||
|
|
@ -57,7 +57,7 @@
|
|||
href="https://github.com/veeso/termscp/blob/main/docs/zh-CN/README.md"
|
||||
><img
|
||||
height="20"
|
||||
src="https://raw.githubusercontent.com/veeso/termscp/main/assets/images/flags/cn.png"
|
||||
src="/assets/images/flags/cn.png"
|
||||
alt="简体中文"
|
||||
/></a>
|
||||
</p>
|
||||
|
|
@ -73,7 +73,7 @@
|
|||
|
||||
## About termscp 🖥
|
||||
|
||||
Termscp is a feature rich terminal file transfer and explorer, with support for SCP/SFTP/FTP/S3. 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**, **FreeBSD** and **Windows** compatible and supports SFTP, SCP, FTP, FTPS and S3.
|
||||
Termscp is a feature rich terminal file transfer and explorer, with support for SCP/SFTP/FTP/S3. 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**, **FreeBSD** and **Windows** compatible.
|
||||
|
||||
|
||||
|
||||
|
|
@ -109,7 +109,7 @@ Termscp is a feature rich terminal file transfer and explorer, with support for
|
|||
## 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)
|
||||
If you want to contribute to this project, don't forget to check out our [contribute guide](CONTRIBUTING.md).
|
||||
|
||||
If you are a Linux, a FreeBSD or a MacOS user this simple shell script will install termscp on your system with a single command:
|
||||
|
||||
|
|
@ -133,7 +133,7 @@ For more information or other platforms, please visit [veeso.github.io](https://
|
|||
- libssh
|
||||
- libdbus-1
|
||||
- pkg-config
|
||||
- **BSD** users:
|
||||
- **FreeBSD** users:
|
||||
- libssh
|
||||
- dbus
|
||||
- pkgconf
|
||||
|
|
@ -142,7 +142,7 @@ For more information or other platforms, please visit [veeso.github.io](https://
|
|||
|
||||
These requirements are not forcely required to run termscp, but to enjoy all of its features
|
||||
|
||||
- **Linux/BSD** users:
|
||||
- **Linux/FreeBSD** users:
|
||||
- To **open** files via `V` (at least one of these)
|
||||
- *xdg-open*
|
||||
- *gio*
|
||||
|
|
@ -156,9 +156,9 @@ These requirements are not forcely required to run termscp, but to enjoy all of
|
|||
|
||||
---
|
||||
|
||||
## Buy me a coffee ☕
|
||||
## Support me ☕
|
||||
|
||||
If you like termscp and you'd love to see the project to grow, please consider a little donation 🥳
|
||||
If you like termscp and you'd love to see the project to grow and to improve, please consider a little donation to support me on **Buy me a coffee** 🥳
|
||||
|
||||
[](https://www.buymeacoffee.com/veeso)
|
||||
|
||||
|
|
@ -221,7 +221,7 @@ View termscp's changelog [HERE](CHANGELOG.md)
|
|||
|
||||
## Powered by 💪
|
||||
|
||||
termscp is powered by these aweseome projects:
|
||||
termscp is powered by these awesome projects:
|
||||
|
||||
- [bytesize](https://github.com/hyunsik/bytesize)
|
||||
- [crossterm](https://github.com/crossterm-rs/crossterm)
|
||||
|
|
|
|||
242
docs/it/README.md
Normal file
242
docs/it/README.md
Normal file
|
|
@ -0,0 +1,242 @@
|
|||
# termscp
|
||||
|
||||
<p align="center">
|
||||
<img src="/assets/images/termscp.svg" width="256" height="256" />
|
||||
</p>
|
||||
|
||||
<p align="center">~ Un file transfer ricco di funzionalità ~</p>
|
||||
<p align="center">
|
||||
<a href="https://veeso.github.io/termscp/" target="_blank">Sito</a>
|
||||
·
|
||||
<a href="https://veeso.github.io/termscp/#get-started" target="_blank">Installazione</a>
|
||||
·
|
||||
<a href="https://veeso.github.io/termscp/#user-manual" target="_blank">Manuale utente</a>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<a href="https://github.com/veeso/termscp"
|
||||
><img
|
||||
height="20"
|
||||
src="/assets/images/flags/us.png"
|
||||
alt="English"
|
||||
/></a>
|
||||
|
||||
<a
|
||||
href="https://github.com/veeso/termscp/blob/main/docs/de/README.md"
|
||||
><img
|
||||
height="20"
|
||||
src="/assets/images/flags/de.png"
|
||||
alt="Deutsch"
|
||||
/></a>
|
||||
|
||||
<a
|
||||
href="https://github.com/veeso/termscp/blob/main/docs/es/README.md"
|
||||
><img
|
||||
height="20"
|
||||
src="/assets/images/flags/es.png"
|
||||
alt="Español"
|
||||
/></a>
|
||||
|
||||
<a
|
||||
href="https://github.com/veeso/termscp/blob/main/docs/fr/README.md"
|
||||
><img
|
||||
height="20"
|
||||
src="/assets/images/flags/fr.png"
|
||||
alt="Français"
|
||||
/></a>
|
||||
|
||||
<a
|
||||
href="https://github.com/veeso/termscp/blob/main/docs/it/README.md"
|
||||
><img
|
||||
height="20"
|
||||
src="/assets/images/flags/it.png"
|
||||
alt="Italiano"
|
||||
/></a>
|
||||
|
||||
<a
|
||||
href="https://github.com/veeso/termscp/blob/main/docs/zh-CN/README.md"
|
||||
><img
|
||||
height="20"
|
||||
src="/assets/images/flags/cn.png"
|
||||
alt="简体中文"
|
||||
/></a>
|
||||
</p>
|
||||
|
||||
<p align="center">Sviluppato da <a href="https://veeso.github.io/">@veeso</a></p>
|
||||
<p align="center">Versione corrente: 0.7.0 (12/10/2021)</p>
|
||||
|
||||
[](https://opensource.org/licenses/MIT) [](https://github.com/veeso/termscp) [](https://crates.io/crates/termscp) [](https://crates.io/crates/termscp)
|
||||
|
||||
[](https://github.com/veeso/termscp/actions) [](https://github.com/veeso/termscp/actions) [](https://github.com/veeso/termscp/actions) [](https://github.com/veeso/termscp/actions) [](https://coveralls.io/github/veeso/termscp) [](https://docs.rs/termscp)
|
||||
|
||||
---
|
||||
|
||||
## Riguardo termscp 🖥
|
||||
|
||||
Termscp è un file transfer ed explorer ricco di funzionalità, con supporto a SCP/SFTP/FTP/S3. Basicamente è un utility su terminale con una terminal user-interface per connettersi a server remoti per scambiare file ed interagire con il file system sia locale che remoto. È compatibile con **Linux**, **MacOS**, **FreeBSD** e **Windows**.
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Funzionalità 🎁
|
||||
|
||||
- 📁 Diversi protocolli di comunicazione
|
||||
- **SFTP**
|
||||
- **SCP**
|
||||
- **FTP** and **FTPS**
|
||||
- **Aws S3**
|
||||
- 🖥 Esplora e opera sia sul file system locale che su quello remoto con una UI di facile utilizzo.
|
||||
- Crea, rimuove, rinomina, cerca, visualizza e modifica file
|
||||
- ⭐ Connettiti ai tuoi host preferiti tramite la funzionalità integrata dei segnalibri e delle connessioni recenti.
|
||||
- 📝 Visualizza e modifica i file tramite le tue applicazioni preferite.
|
||||
- 💁 Autenticazione su server SFTP/SCP tramite chiavi SSH e/o username/password
|
||||
- 🐧 Compatibile con Windows, Linux, FreeBSD e MacOS
|
||||
- 🎨 Customizzalo!
|
||||
- Temi
|
||||
- Formattazione dell'explorer
|
||||
- Impostazione del text editor predefinito
|
||||
- Imposta l'ordinamento di file e cartelle
|
||||
- e tanto altro...
|
||||
- 📫 Ricevi notifiche desktop quando un file di cospicue dimensioni è stato trasferito
|
||||
- 🔐 Salva le password degli host remoti nel keyring predefinito dal tuo sistema operativo
|
||||
- 🦀 Rust-powered
|
||||
- 👀 Progettato tenendo conto delle performance
|
||||
- 🦄 Aggiornamenti frequenti con nuove funzionalità
|
||||
|
||||
---
|
||||
|
||||
## Per iniziare 🚀
|
||||
|
||||
Intanto se stai considerando di installare termscp, ti voglio ringraziare 💜 e spero che termscp ti piacerà!
|
||||
Se vuoi contribuire al progetto, non dimenticarti di leggere la [contribute guide](../../CONTRIBUTING.md).
|
||||
|
||||
Se sei un utente che utilizza Linux, FreeBSD o MacOS, questo shell script installerà termscp sul tuo sistema con un comando secco:
|
||||
|
||||
```sh
|
||||
curl --proto '=https' --tlsv1.2 -sSLf "https://git.io/JBhDb" | sh
|
||||
```
|
||||
|
||||
mentre se sei un utente Windows, puoi installare termscp con [Chocolatey](https://chocolatey.org/):
|
||||
|
||||
```sh
|
||||
choco install termscp
|
||||
```
|
||||
|
||||
Per ulteriori informazioni sui metodi di installazione su altre piattaforme, visita [veeso.github.io](https://veeso.github.io/termscp/#get-started).
|
||||
|
||||
⚠️ Se stavi cercando come aggiornare la tua versione di termscp, puoi semplicemente lanciare termscp con questi argomenti: `(sudo) termscp --update` ⚠️
|
||||
|
||||
### Requisiti ❗
|
||||
|
||||
- Utenti **Linux**:
|
||||
- libssh
|
||||
- libdbus-1
|
||||
- pkg-config
|
||||
- Utenti **FreeBSD**:
|
||||
- libssh
|
||||
- dbus
|
||||
- pkgconf
|
||||
|
||||
### Requisiti opzionali ✔️
|
||||
|
||||
Questi requisiti non sono per forza necessari, ma lo sono per sfruttare tutte le sue funzionalità:
|
||||
|
||||
- Utenti **Linux/FreeBSD**:
|
||||
- Per **aprire** i file con `V` (almeno uno di questi)
|
||||
- *xdg-open*
|
||||
- *gio*
|
||||
- *gnome-open*
|
||||
- *kde-open*
|
||||
- Utenti **Linux**:
|
||||
- Un keyring manager: Approfondisci nel [Manuale](man.md#linux-keyring)
|
||||
- Utenti **WSL**
|
||||
- Per **aprire** i file con `V` (almeno uno di questi)
|
||||
- [wslu](https://github.com/wslutilities/wslu)
|
||||
|
||||
---
|
||||
|
||||
## Supportami ☕
|
||||
|
||||
Se ti piace termscp e ti piacerebbe vedere il progetto crescere e migliorare, considera una piccola donazione su **Buy me a coffee** 🥳.
|
||||
|
||||
[](https://www.buymeacoffee.com/veeso)
|
||||
|
||||
---
|
||||
|
||||
## Manuale e documentazione 📚
|
||||
|
||||
Il manuale utente lo puoi trovare sul [sito di termscp](https://veeso.github.io/termscp/#user-manual) o su [Github](man.md).
|
||||
|
||||
La documentazione per sviluppatori la puoi trovare su Rust Docs <https://docs.rs/termscp>.
|
||||
|
||||
---
|
||||
|
||||
## Problemi noti 🧻
|
||||
|
||||
- `NoSuchFileOrDirectory` alla connessione (WSL1): Dovrebbe essere sufficiente non installare termscp con Cargo, ma piuttosto con uno dei pacchetti forniti tramite lo script di installazione `install.sh`. Si tratta di un problema legato esclusivamente a WSL1 e non è chiaro cosa accada alla connessione, ma è sicuramente legato al percorso del file.
|
||||
|
||||
---
|
||||
|
||||
## Contributi e issues 🤝🏻
|
||||
|
||||
Contributi, report di bug, nuove funzionalità e domande sono i benvenuti! 😉
|
||||
Se hai qualche domanda o dubbio o vuoi suggerire una nuova funzionalità, sentiti libero di aprire un issue o una PR.
|
||||
|
||||
Per favore segui le nostre [contributing guidelines](../../CONTRIBUTING.md)
|
||||
|
||||
---
|
||||
|
||||
## Changelog ⏳
|
||||
|
||||
Visualizza [Qui](../../CHANGELOG.md) il changelog
|
||||
|
||||
---
|
||||
|
||||
## Un grazie a questi progetti 💪
|
||||
|
||||
se termscp esiste, è anche grazie a questi fantastici progetti:
|
||||
|
||||
- [bytesize](https://github.com/hyunsik/bytesize)
|
||||
- [crossterm](https://github.com/crossterm-rs/crossterm)
|
||||
- [edit](https://github.com/milkey-mouse/edit)
|
||||
- [keyring-rs](https://github.com/hwchen/keyring-rs)
|
||||
- [open-rs](https://github.com/Byron/open-rs)
|
||||
- [rpassword](https://github.com/conradkleinespel/rpassword)
|
||||
- [rust-s3](https://github.com/durch/rust-s3)
|
||||
- [self_update](https://github.com/jaemk/self_update)
|
||||
- [ssh2-rs](https://github.com/alexcrichton/ssh2-rs)
|
||||
- [suppaftp](https://github.com/veeso/suppaftp)
|
||||
- [textwrap](https://github.com/mgeisler/textwrap)
|
||||
- [tui-rs](https://github.com/fdehau/tui-rs)
|
||||
- [tui-realm](https://github.com/veeso/tui-realm)
|
||||
- [whoami](https://github.com/libcala/whoami)
|
||||
- [wildmatch](https://github.com/becheran/wildmatch)
|
||||
|
||||
---
|
||||
|
||||
## Galleria 🎬
|
||||
|
||||
> Termscp Home
|
||||
|
||||
|
||||
|
||||
> Bookmarks
|
||||
|
||||
|
||||
|
||||
> Configurazione
|
||||
|
||||
|
||||
|
||||
> Text editor
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Licenza 📃
|
||||
|
||||
termscp è fornito sotto licenza MIT.
|
||||
|
||||
Puoi leggere l'intero documento di licenza [Qui](../../LICENSE)
|
||||
484
docs/it/man.md
Normal file
484
docs/it/man.md
Normal file
|
|
@ -0,0 +1,484 @@
|
|||
# Manuale utente 🎓
|
||||
|
||||
- [Manuale utente 🎓](#manuale-utente-)
|
||||
- [Argomenti da linea di comando ❓](#argomenti-da-linea-di-comando-)
|
||||
- [Argomento indirizzo 🌎](#argomento-indirizzo-)
|
||||
- [Argomento indirizzo per AWS S3](#argomento-indirizzo-per-aws-s3)
|
||||
- [Come fornire la password 🔐](#come-fornire-la-password-)
|
||||
- [File explorer 📂](#file-explorer-)
|
||||
- [Abbinamento tasti ⌨](#abbinamento-tasti-)
|
||||
- [Lavora su più file 🥷](#lavora-su-più-file-)
|
||||
- [Synchronized browsing ⏲️](#synchronized-browsing-️)
|
||||
- [Apri e apri con 🚪](#apri-e-apri-con-)
|
||||
- [Segnalibri ⭐](#segnalibri-)
|
||||
- [Le mie password sono al sicuro 😈](#le-mie-password-sono-al-sicuro-)
|
||||
- [Linux Keyring](#linux-keyring)
|
||||
- [KeepassXC setup per termscp](#keepassxc-setup-per-termscp)
|
||||
- [Credenziali Aws S3 🦊](#credenziali-aws-s3-)
|
||||
- [Configurazione ⚙️](#configurazione-️)
|
||||
- [SSH Key Storage 🔐](#ssh-key-storage-)
|
||||
- [File Explorer Format](#file-explorer-format)
|
||||
- [Temi 🎨](#temi-)
|
||||
- [Il tema non carica 😱](#il-tema-non-carica-)
|
||||
- [Stili 💈](#stili-)
|
||||
- [Pagina autenticazione](#pagina-autenticazione)
|
||||
- [Pagina explorer e trasferimento](#pagina-explorer-e-trasferimento)
|
||||
- [Misc](#misc)
|
||||
- [Editor di testo ✏](#editor-di-testo-)
|
||||
- [Logging 🩺](#logging-)
|
||||
- [Notifiche 📫](#notifiche-)
|
||||
|
||||
## Argomenti da linea di comando ❓
|
||||
|
||||
termscp può essere lanciato con questi argomenti:
|
||||
|
||||
`termscp [options]... [protocol://user@address:port:wrkdir] [local-wrkdir]`
|
||||
|
||||
- `-P, --password <password>` Se viene fornito l'argomento indirizzo, questa sarà la password utilizzata per autenticarsi
|
||||
- `-c, --config` Apri la configurazione di termscp
|
||||
- `-q, --quiet` Disabilita i log
|
||||
- `-t, --theme <path>` Importa il tema al percorso fornito
|
||||
- `-u, --update` Aggiorna termscp all'ultima versione
|
||||
- `-v, --version` Mostra a video le informazioni sulla versione attualmente installata
|
||||
- `-h, --help` Mostra la pagina di aiuto.
|
||||
|
||||
termscp può venire lanciato in due modalità diverse. Se nessun argomento posizionale viene fornito, termscp mostrerà il form di autenticazione, dove l'utente potrà fornire i parametri di connessione necessari.
|
||||
Alternativamente, l'utente può fornire l'argomento posizionale "indirizzo" per connettersi direttamente all'host fornito.
|
||||
Se viene fornito anche il secondo argomento posizionale, ovvero la directory locale, termscp avvierà l'explorer locale sul percorso fornito.
|
||||
|
||||
### Argomento indirizzo 🌎
|
||||
|
||||
L'argomento indirizzo ha la sintassi seguente:
|
||||
|
||||
```txt
|
||||
[protocollo://][username@]<indirizzo>[:porta][:wrkdir]
|
||||
```
|
||||
|
||||
Vediamo qualche esempio per questa sintassi, dal momento che risulta molto comodo connettersi tramite questa modalità:
|
||||
|
||||
- Connessione utilizzando il protocollo di default (definito in configurazione) a 192.168.1.31, la porta sarà quella di default per il protocollo di default. Il nome utente è quello attualmente attivo sulla propria macchina:
|
||||
|
||||
```sh
|
||||
termscp 192.168.1.31
|
||||
```
|
||||
|
||||
- Connessione con protocollo di default a 192.168.1.31, utente è `root`:
|
||||
|
||||
```sh
|
||||
termscp root@192.168.1.31
|
||||
```
|
||||
|
||||
- Connessione usando `scp`, la porta è 4022, l'utente è `omar`:
|
||||
|
||||
```sh
|
||||
termscp scp://omar@192.168.1.31:4022
|
||||
```
|
||||
|
||||
- Connessione via `scp`, porta 4022, utente `omar`, l'explorer si avvierà in `/tmp`:
|
||||
|
||||
```sh
|
||||
termscp scp://omar@192.168.1.31:4022:/tmp
|
||||
```
|
||||
|
||||
#### Argomento indirizzo per AWS S3
|
||||
|
||||
Aws S3 ha una sintassi differente dal classico argomento indirizzo, per ovvie ragioni, in quanto S3 non ha la porta o l'host o l'utente. Ho deciso però di mantenere una sintassi il più simile possibile a quella "tradizionale":
|
||||
|
||||
```txt
|
||||
s3://<bucket-name>@<region>[:profile][:/wrkdir]
|
||||
```
|
||||
|
||||
e.g.
|
||||
|
||||
```txt
|
||||
s3://buckethead@eu-central-1:default:/assets
|
||||
```
|
||||
|
||||
#### Come fornire la password 🔐
|
||||
|
||||
Quando si usa l'argomento indirizzo non è possibile fornire la password direttamente nell'argomento, esistono però altri metodi per farlo:
|
||||
|
||||
- Argomento `-P, --password <password>`: Passa direttamente la password nell'argomento. Non lo consiglio particolarmente questo metodo, in quanto la password rimarrebbe nella history della shell in chiaro.
|
||||
- Tramite `sshpass`: puoi fornire la password tramite l'applicazione GNU/Linux sshpass `sshpass -f ~/.ssh/topsecret.key termscp cvisintin@192.168.1.31`
|
||||
- Forniscila quando richiesta: se non la fornisci tramite nessun metodo precedente, alla connessione ti verrà richiesto di fornirla in un prompt che la oscurerà (come avviene con sudo tipo).
|
||||
|
||||
---
|
||||
|
||||
## File explorer 📂
|
||||
|
||||
Quando ci riferiamo al file explorer in termscp, intendiamo i pannelli che puoi vedere quando stabilisci una connessione con il server remoto.
|
||||
Questi pannelli sono 3 (e non 2 come sembra):
|
||||
|
||||
- Pannello locale: viene visualizzato sulla sinistra del tuo schermo e mostra la cartella sul file system locale.
|
||||
- Pannello remoto: viene visualizzato sulla destra del tuo schermo e mostra la cartella sul file system remoto.
|
||||
- Pannello di ricerca: viene visualizzato a destra o a sinistra in base a dove stai cercando dei file. Questo pannello mostra i file che matchano al pattern cercato sull'host.
|
||||
|
||||
Per cambiare pannello ti puoi muovere con le frecce, `<LEFT>` per andare sul pannello locale e `<RIGHT>` per andare su quello remoto. Attenzione che quando è attivo il pannello ricerca non puoi spostarti sugli altri pannelli e devi prima chiuderlo con `<ESC>`.
|
||||
|
||||
### Abbinamento tasti ⌨
|
||||
|
||||
| Key | Command | Reminder |
|
||||
|---------------|-------------------------------------------------------|-------------|
|
||||
| `<ESC>` | Disconnettiti; chiudi popup | |
|
||||
| `<TAB>` | Cambia tra explorer e pannello di log | |
|
||||
| `<BACKSPACE>` | Vai alla directory precedente | |
|
||||
| `<RIGHT>` | Vai al pannello remoto | |
|
||||
| `<LEFT>` | Vai al pannello locale | |
|
||||
| `<UP>` | Muovi il cursore verso l'alto | |
|
||||
| `<DOWN>` | Muovi il cursore verso il basso | |
|
||||
| `<PGUP>` | Muovi il cursore verso l'alto di 8 | |
|
||||
| `<PGDOWN>` | Muovi il cursore verso il basso di 8 | |
|
||||
| `<ENTER>` | Entra nella directory | |
|
||||
| `<SPACE>` | Upload / download file selezionato/i | |
|
||||
| `<A>` | Mostra/nascondi file nascosti | All |
|
||||
| `<B>` | Ordina file per | Bubblesort? |
|
||||
| `<C>` | Copia file/directory | Copy |
|
||||
| `<D>` | Crea directory | Directory |
|
||||
| `<E>` | Elimina file (Come `DEL`) | Erase |
|
||||
| `<F>` | Cerca file (wild match supportato) | Find |
|
||||
| `<G>` | Vai al percorso indicato | Go to |
|
||||
| `<H>` | Mostra help | Help |
|
||||
| `<I>` | Mostra informazioni per il file selezionato | Info |
|
||||
| `<L>` | Ricarica posizione corrente / pulisci selezione file | List |
|
||||
| `<M>` | Seleziona file | Mark |
|
||||
| `<N>` | Crea nuovo file con il nome fornito | New |
|
||||
| `<O>` | Modifica file; Vedi text editor | Open |
|
||||
| `<Q>` | Termina termscp | Quit |
|
||||
| `<R>` | Rinomina file | Rename |
|
||||
| `<S>` | Salva file con nome | Save |
|
||||
| `<U>` | Vai alla directory padre | Upper |
|
||||
| `<V>` | Apri il file con il programma definito dal sistema | View |
|
||||
| `<W>` | Apri il file con il programma specificato | With |
|
||||
| `<X>` | Esegui comando shell | eXecute |
|
||||
| `<Y>` | Abilita/disabilita Sync-Browsing | sYnc |
|
||||
| `<DEL>` | Rimuovi file | |
|
||||
| `<CTRL+A>` | Seleziona tutti i file | |
|
||||
| `<CTRL+C>` | Annulla trasferimento file | |
|
||||
|
||||
### Lavora su più file 🥷
|
||||
|
||||
Puoi lavorare su una selezione di file, marcandoli come selezionati tramite `<M>`, per selezionare il file corrente o con `<CTRL+A` per selezionarli tutti.
|
||||
Una volta che un file è marcato, sarà visualizzato con un `*` prima del nome.
|
||||
Quando lavori con una selezioni, solo i file selezionati saranno presi in considerazione (l'eventuale file evidenziato sarà ignorato).
|
||||
È possibile operare su più file anche nel pannello di ricerca.
|
||||
Tutte le azioni sono disponibili quando si lavora sulle selezioni, ma occhio, che alcune azioni si comporteranno in maniera leggermente differente. Vediamo quali e come:
|
||||
|
||||
- *Copia*: Se copi un file, ti verrà richiesto di inserire il nome delle destinazione, ma quando lavori con la selezione, il nome si riferisce alla directory di destinazione, mentre il nome del file rimarrà inviariato.
|
||||
- *Rinomina*: Come il copia, ma li sposterà.
|
||||
- *Salva con nome*: Come il copia, ma li trasferirà.
|
||||
|
||||
### Synchronized browsing ⏲️
|
||||
|
||||
Quando abilitato, ti permetterà di sincronizzare la navigazione tra i due pannelli.
|
||||
Ciò comporta che quando cambierai directory in uno dei due pannelli, lo stesso verrà fatto nell'altro. Per abilitare la modalità è sufficiente premere `<Y>`; fai lo stesso per disabilitarlo. Mentre abilitato, sull'interfaccia dovrebbe essere visualizzato `Sync Browsing: ON` nella barra di stato.
|
||||
|
||||
> ❗ Al momento, se provi ad accedere ad una cartella non esistente su uno dei due host, mentre il sync browsing è attivo, non ti verrà chiesto di crearla, ma semplicemente fallirà. Questo sarà risolto in un aggiornamento futuro.
|
||||
|
||||
### Apri e apri con 🚪
|
||||
|
||||
I comandi "apri" e "apri con" sono forniti da [open-rs](https://docs.rs/crate/open/2.1.0).
|
||||
Quando apri un file (`<V>`), l'applicazione predefinita di sistema sarà utilizzata per aprire il file. Per fare ciò, sul tuo sistema dovrà essere usato il servizio di default del sistema.
|
||||
|
||||
- **Windows**: non devi installare niente, è già presente sul sistema.
|
||||
- **MacOS**: non devi installare niente, è già presente sul sistema.
|
||||
- **Linux**: uno di questi dev'essere presente (potrebbe già esserlo):
|
||||
- *xdg-open*
|
||||
- *gio*
|
||||
- *gnome-open*
|
||||
- *kde-open*
|
||||
- **WSL**: *wslview* è richiesto, lo puoi installare tramite questa suite [wslu](https://github.com/wslutilities/wslu).
|
||||
|
||||
> Q: Posso modificare i file su remoto tramite la funzionalità "apri" / "apri con"?
|
||||
> A: No, almeno non direttamente dal pannello remoto. Devi prima scaricarlo in locale, modificarlo e poi ricaricarlo. Questo perché il file remoto viene scaricato come file temporaneo in locale, ma non esiste poi un modo per sapere quando è stato modificato e quando l'utente ha effettivamente finito di lavorarci.
|
||||
|
||||
---
|
||||
|
||||
## Segnalibri ⭐
|
||||
|
||||
In termscp è possibile salvare i tuoi host preferiti tramite i segnalibri al fine di connettersi velocemente ad essi.
|
||||
Termscp salverà anche gli ultimi 16 host ai quali ti sei connesso.
|
||||
Questa funzionalità ti permette di caricare tutti i parametri necessari per connettersi ad un certo host, semplicemente selezioandolo dal tab dei preferiti nel form di autenticazione.
|
||||
|
||||
I preferiti saranno salvati se possibile presso:
|
||||
|
||||
- `$HOME/.config/termscp/` su Linux/BSD
|
||||
- `$HOME/Library/Application Support/termscp` su MacOs
|
||||
- `FOLDERID_RoamingAppData\termscp\` su Windows
|
||||
|
||||
Per i segnalibri (ma non per le connessioni recenti), è anche possibile salvare la password. La password non viene salvata di default e deve essere specificato tramite apposita opzione, al momento della creazione del segnalibro stesso.
|
||||
Se sei preoccupato riguardo alla sicurezza della password per i segnalibri, dai un'occhiata al capitolo qui sotto 👀.
|
||||
|
||||
Per creare un segnalibro, segui questa procedura:
|
||||
|
||||
1. Inserisci i parametri per connetterti all'host che vuoi inserire come segnalibro nell'authentication form.
|
||||
2. Premi `<CTRL+S>`
|
||||
3. Inserisci il nome che vuoi dare al bookmark
|
||||
4. Seleziona nel radio button se salvare la password
|
||||
5. Premi `<ENTER>` per salvare
|
||||
|
||||
Quando vuoi caricare un segnalibro, premi `<TAB>` e naviga nella lista dei segnalibri fino al segnalibro che vuoi caricare, quindi premi `<ENTER>`.
|
||||
|
||||
|
||||
|
||||
### Le mie password sono al sicuro 😈
|
||||
|
||||
Certo 😉.
|
||||
Come detto in precedenza, i segnalibri sono salvati nella cartella delle configurazioni insieme alle password. Le password però non sono in chiaro, ma bensì sono criptate con **AES-128**. Questo le rende sicure? Sì! Does this make them safe? (salvo che per gli utenti di FreeBSD e WSL 😢)
|
||||
|
||||
In **Windows**, **Linux** and **MacOS** la chiave per criptare le password è salvata, se possibile, rispettivamente nel *Windows Vault*, nel *system keyring* e nel *Keychain*. Questo sistema è super-sicuro, in quanto garantito direttamente dal tuo sistema operativo.
|
||||
|
||||
❗ Attenzione che se sei un utente Linux, dovresti leggere il capitolo qui sotto riguardante il linux keyring 👀, questo perché il keyring potrebbe non essere ancora presente sul tuo sistema.
|
||||
|
||||
Su *FreeBSD* e *WSL*, d'altro canto, la chiave utilizzata per criptare le password è salvata su file presso (at $HOME/.config/termscp). È quindi possibile per un malintenzionato ottenere la chiave. Per fortuna essendo sotto la tua home, non dovrebbe essere possibile accedere al file, se non con il tuo utente, ma comunque per sicurezza ti consiglio di non salvare dati sensibili 😉.
|
||||
|
||||
#### Linux Keyring
|
||||
|
||||
Tutti gli amanti di Linux lo preferiscono per la libertà che questo dà agli utenti nella personalizzazione. Allo stesso tempo però questo spesso comporta degli effetti collaterali, tra cui la mancanza spesso di un'imposizione da parte dei creatori delle distro di standard e applicazioni e questo fatto coinvolge anche la questione del keyring.
|
||||
Su alcuni sistemi di default, non c'è nessun provider di keyring, perché la distro dà all'utente la possibilità di sceglierne uno.
|
||||
termscp richiede un servizio D-BUS che fornisce `org.freedesktop.secrets` e purtroppo ci sono ad oggi solo due servizi mantenuti che lo supportano.
|
||||
|
||||
- ❗ Se usi GNOME come Desktop environment (come gli utenti Ubuntu), dovresti già averne uno installato sul sistema, chiamato `gnome-keyring` e quindi dovrebbe già funzionare tutto.
|
||||
- ❗ Se invece usi un altro DE, dovresti installare [KeepassXC](https://keepassxc.org/), che io per esempio utilizzo sul mio Manjaro Linux (con KDE) e funziona piuttosto bene. L'unico problema è che dovrai fare il setup per farlo funzionare. Per farlo puoi leggere il tutorial [qui](#keepassxc-setup-per-termscp)
|
||||
- ❗ Se non volessi installare uno di questi servizi, termscp funzionerà come sempre, l'unica differenza sarà che salverà la chiave di crittazione su un file, come fa per FreeBSD e WSL.
|
||||
|
||||
##### KeepassXC setup per termscp
|
||||
|
||||
Questo tutorial spiega come impostare KeepassXC per termscp.
|
||||
|
||||
1. Installa KeepassXC dal sito ufficiale <https://keepassxc.org/>
|
||||
2. Una volta avviato, vai su "strumenti" > "impostazioni" nella toolbar
|
||||
3. Seleziona "Secret service integration" e abilita "Enable KeepassXC freedesktop.org secret service integration"
|
||||
4. Crea un database se non ne hai già uno: dalla toolbar "Database" > "Nuovo database"
|
||||
5. Dalla toolbar: "Database" > "Impostazioni database"
|
||||
6. Seleziona "Secret service integration" e abilita "Expose entries under this group"
|
||||
7. Seleziona il gruppo in cui vuoi salvare le chiavi di termscp. Attenzione che questo gruppo sarà utilizzato da tutte le altre eventuali applicazioni che salvano le password via D-BUS.
|
||||
|
||||
---
|
||||
|
||||
## Credenziali Aws S3 🦊
|
||||
|
||||
Per connettersi ad un bucket S3 devi come già saprai fornire le credenziali fornite da AWS.
|
||||
Ci sono due modi per passare queste credenziali a termscp e come avrai già notato **non puoi** farlo dal form di autenticazione.
|
||||
Questi sono quindi i due modi per passare le chiavi:
|
||||
|
||||
1. Utilizza il file delle credenziali s3: configurando aws via `aws configure` le tue credenziali dovrebbero già venir salvate in `~/.aws/credentials`. Nel caso tu debba usare un profile diverso da `default`, puoi fornire un profilo diverso nell'authentication form.
|
||||
2. **Variabili d'ambiente**: nel caso il primo metodo non sia utilizzabile, puoi comunque fornirle come variabili d'ambiente. Considera però che queste variabili sovrascriveranno sempre le credenziali situate nel file credentials. Vediamo come impostarle:
|
||||
|
||||
Queste sono sempre obbligatorie:
|
||||
|
||||
- `AWS_ACCESS_KEY_ID`: aws access key ID (di solito inizia per `AKIA...`)
|
||||
- `AWS_SECRET_ACCESS_KEY`: la secret access key
|
||||
|
||||
nel caso tu abbia impostato un maggiore livello di sicurezza, potrebbero servirti anche queste:
|
||||
|
||||
- `AWS_SECURITY_TOKEN`: security token
|
||||
- `AWS_SESSION_TOKEN`: session token
|
||||
|
||||
⚠️ le tue credenziali sono al sicuro: termscp non manipola direttamente questi dati! Le credenziali sono direttamente lette dal crate di **s3**. Nel caso tu abbia dei dubbi sulla sicurezza, puoi contattare l'autore della libreria su [Github](https://github.com/durch/rust-s3) ⚠️
|
||||
|
||||
---
|
||||
|
||||
## Configurazione ⚙️
|
||||
|
||||
termscp supporta diversi parametri definiti dall'utente, che possono essere impostati nella configurazione.
|
||||
termscp usa un file TOML e altre directory per salvare tutti i parametri, ma non preoccuparti, tutto può essere comodamente configurato da interfaccia grafica.
|
||||
|
||||
Per la configurazione, termscp richiede che i seguenti percorsi siano accessibili (termscp proverà a crearli per te):
|
||||
|
||||
- `$HOME/.config/termscp/` su Linux/BSD
|
||||
- `$HOME/Library/Application Support/termscp` su MacOs
|
||||
- `FOLDERID_RoamingAppData\termscp\` su Windows
|
||||
|
||||
Per accedere alla configurazione è sufficiente premere `<CTRL+C>` dall'authentication form.
|
||||
|
||||
Questi parametri possono essere impostati:
|
||||
|
||||
- **Text Editor**: l'editor di testo da utilizzare per aprire i file. Di default termscp userà quello definito nella variabile `EDITOR` od il primo che troverà installato tra quelli più popolari. Puoi tuttavia definire quello che vuoi (ad esempio `vim`). **Anche gli editor GUI sono supportati**, a meno che loro non partano in `nohup` dal processo padre, quindi se vuoi saperlo: sì puoi utilizzare `notepad.exe`, ma non **Visual Studio Code**.
|
||||
- **Default Protocol**: il protocollo di default da visualizzare come prima opzione nell'authentication form. Questa opzione sarà anche utilizzata quando si usa l'argomento indirizzo da CLI e non si specifica un protocollo.
|
||||
- **Show Hidden Files**: seleziona se mostrare di default i file nascosti. A runtime potrai comunque scegliere se visualizzarli o meno premendo `<A>`.
|
||||
- **Check for updates**: se impostato a `YES` all'avvio termscp controllerà l'eventuale presenza di aggiornamenti. Per farlo utilizzerà una chiamata GET all'API di Github.
|
||||
- **Prompt when replacing existing files?**: se impostato a `yes`, termscp ti chiederà una conferma prima di sovrascrivere un file a seguito di un download/upload.
|
||||
- **Group Dirs**: seleziona se e come raggruppare le cartelle negli explorer. Se `Display first` è impostato, le directory verranno ordinate secondo quanto stabilito nel `sort by`, ma verranno messe prima dei file, viceversa se `Display last` è utilizzato. Se invece metti `no`, le cartelle verrano messe in ordine assieme ad i file.
|
||||
- **Remote File formatter syntax**: La formattazione da usare per formattare i file sull'explorer remoto. Vedi [File explorer format](#file-explorer-format)
|
||||
- **Local File formatter syntax**: La formattazione da usare per formattare i file sull'explorer locale. Vedi [File explorer format](#file-explorer-format)
|
||||
- **Enable notifications?**: Se impostato a `yes`, le notifiche desktop saranno abilitate.
|
||||
- **Notifications: minimum transfer size**: se la dimensione di un trasferimento supera o è uguale al valore impostato, al termine del trasferimento riceverai una notifica desktop (se queste sono abilitate). Il formato del valore dev'essere `{UNSIGNED} B/KB/MB/GB/TB/PB`
|
||||
|
||||
### SSH Key Storage 🔐
|
||||
|
||||
Assieme alla configurazione termscp supporta anche una feature essenziale per i client **SFTP/SCP**: lo storage di chiavi SSH.
|
||||
|
||||
Puoi accedere allo storage muovendoti nel tab delle chiavi SSH tramite `<TAB>` dalla configurazione.
|
||||
|
||||
- **Aggiungere chiavi**: premi `<CTRL+N>` e ti verrà chiesto di creare una nuova chiave. Inserisci l'hostname/indirizzo ed il nome utente, infine una volta che premerai invio, ti si aprirà l'editor di testo: incolla la chiave SSH **PRIVATA**, salva ed esci.
|
||||
- **Rimuovi una chiave esistente**: premi `<DEL>` o `<CTRL+E>` selezionando la chiave da rimuovere.
|
||||
- **Aggiorna una chiave esistente**: premi `<ENTER>` sulla chiave che vuoi modificare.
|
||||
|
||||
> Q: Se la mia chiave è protetta da password, posso comunque usarla?
|
||||
> A: Sì, certo. In questo caso dovrai fornire la password come faresti per autenticarti con utente/password, ma in questo caso la password sarà usata per decrittare la chiave.
|
||||
|
||||
### File Explorer Format
|
||||
|
||||
È possibile dalla configurazione impostare la formattazione dei file sull'explorer. È possibile sia farlo per il pannello locale, che per quello remoto; quindi puoi avere due sintassi diverse. Questi campi, con nome `File formatter syntax (local)` and `File formatter syntax (remote)` definiranno come i file devono essere formattati sull'explorer.
|
||||
La sintassi è la seguente `{KEY1}... {KEY2:LENGTH}... {KEY3:LENGTH:EXTRA} {KEYn}...`.
|
||||
Ogni chiave sarà rimpiazzata dal formatter con il relativo attributo, mentre tutto ciò che è fuori dalle parentesi graffe rimarrà inviariato (quindi puoi metterci del testo arbitratio).
|
||||
|
||||
- Il nome della chiave è obbligatorio e dev'essere uno di quelli sotto.
|
||||
- La lunghezza descrive quanto spazio in caratteri riservare al campo. Attributi con dimensione statico (GROUP, PEX, SIZE, USER) non supportano la lunghezza.
|
||||
- L'extra serve a definire degli attributi in più. Solo alcuni lo supportano.
|
||||
|
||||
These are the keys supported by the formatter:
|
||||
|
||||
- `ATIME`: Last access time (con sintassi di default `%b %d %Y %H:%M`); Extra definisce il formato data (e.g. `{ATIME:8:%H:%M}`)
|
||||
- `CTIME`: Creation time (con sintassi di default `%b %d %Y %H:%M`); Extra definisce il formato data (e.g. `{CTIME:8:%H:%M}`)
|
||||
- `GROUP`: Owner group
|
||||
- `MTIME`: Last change time (con sintassi di default `%b %d %Y %H:%M`); Extra definisce il formato data (e.g. `{MTIME:8:%H:%M}`)
|
||||
- `NAME`: Nome file (Elided if longer than LENGTH)
|
||||
- `PEX`: Permessi utente (formato UNIX)
|
||||
- `SIZE`: Dimensione file (omesso per le directory)
|
||||
- `SYMLINK`: Link simbolico (se presente `-> {FILE_PATH}`)
|
||||
- `USER`: Owner user
|
||||
|
||||
Se lasciata vuota, la sintassi di default sarà utilizzata: `{NAME:24} {PEX} {USER} {SIZE} {MTIME:17:%b %d %Y %H:%M}`
|
||||
|
||||
---
|
||||
|
||||
## Temi 🎨
|
||||
|
||||
termscp fornisce anche una funzionalità strafiga: la possibilità di impostare i colori per tutta l'interfaccia.
|
||||
Se vuoi impostare i colori, ci sono due modi per farlo:
|
||||
|
||||
- dal **menù di configurazione**
|
||||
- importando un **tema** da file
|
||||
|
||||
Per personalizzare i colori dovrai andare nella configurazione temi, partendo dal menù di autenticazione, premendo `<CTRL+C>` e premendo due volte `<TAB>`. Dovresti essere quindi in configurazione nel tab `themes`.
|
||||
|
||||
Da qui puoi spostarti con le frecce per cambiare lo stile che vuoi, come mostrato nella GIF qua sotto:
|
||||
|
||||
|
||||
|
||||
termscp supporta diverse sintassi per i colori, sia il formato hex (`#rrggbb`) che rgb `rgb(r, g, b)`, ma anche i **[colori CSS](https://www.w3schools.com/cssref/css_colors.asp)** (tipo `crimson`) 😉. C'è anche una chiave speciale `Default`. Default significa che per il colore verrà usato il default in base al tipo di elemento (foreground per i testi e linee, background per gli sfondi e i riempimenti).
|
||||
|
||||
Come detto già in precedenza, puoi anche importare i temi da file. Volendo puoi anche creare un tema prendendo ispirazione da quelli situati nella cartella `themes/` del repository ed importarli su termscp con `termscp -t <theme_file>`. Se l'operazione va a buon fine dovrebbe dirti che l'ha importato con successo.
|
||||
|
||||
### Il tema non carica 😱
|
||||
|
||||
Probabilmente è dovuto ad un aggiornamento che ha rotto il tema. Se viene aggiunta una nuova chiave nel tema (ma questo accade molto raramente), il tema non verrà più caricato. Ci sono diverse soluzioni veloci per questo problema.
|
||||
|
||||
1. Ricarica il tema: se stai usando un tema "ufficiale" fornito nel repository, basterà ricaricarlo, perché li aggiorno sempre quando modifico i temi:
|
||||
|
||||
```sh
|
||||
termscp -t <theme.toml>
|
||||
```
|
||||
|
||||
2. Sistema il tuo tema a mano: puoi modificare il tuo tema con un editor di testo tipo `vim` e aggiungere la chiave mancante. Il il tema si trova in `$CONFIG_DIR/termscp/theme.toml` dove `$CONFIG_DIR` è:
|
||||
|
||||
- FreeBSD/GNU-Linux: `$HOME/.config/`
|
||||
- MacOs: `$HOME/Library/Application Support`
|
||||
- Windows: `%appdata%`
|
||||
|
||||
❗ Le chiavi mancanti vengono riportate nel CHANGELOG sotto `BREAKING CHANGES` per la versione installata.
|
||||
|
||||
### Stili 💈
|
||||
|
||||
Puoi trovare qui sotto la definizione per ogni chiave.
|
||||
Attenzione che gli stili **non coinvolgono la pagina di configurazione**, per renderla sempre accessibile nel caso gli stili siano inutilizzabili.
|
||||
|
||||
#### Pagina autenticazione
|
||||
|
||||
| Key | Description |
|
||||
|----------------|------------------------------------|
|
||||
| auth_address | Colore del campo indirizzo IP |
|
||||
| auth_bookmarks | Colore del pannello segnalibri |
|
||||
| auth_password | Colore del campo password |
|
||||
| auth_port | Colore del campo numero porta |
|
||||
| auth_protocol | Colore del selettore di protocollo |
|
||||
| auth_recents | Colore del pannello recenti |
|
||||
| auth_username | Colore del campo nome utente |
|
||||
|
||||
#### Pagina explorer e trasferimento
|
||||
|
||||
| Key | Description |
|
||||
|--------------------------------------|---------------------------------------------------------------------------|
|
||||
| transfer_local_explorer_background | Sfondo explorer locale |
|
||||
| transfer_local_explorer_foreground | Foreground explorer locale |
|
||||
| transfer_local_explorer_highlighted | Colore bordo e file selezionato explorer locale |
|
||||
| transfer_remote_explorer_background | Sfondo explorer remoto |
|
||||
| transfer_remote_explorer_foreground | Foreground explorer remoto |
|
||||
| transfer_remote_explorer_highlighted | Colore bordo e file selezionato explorer remoto |
|
||||
| transfer_log_background | Sfondo pannello di log |
|
||||
| transfer_log_window | Colore bordi e testo log |
|
||||
| transfer_progress_bar_partial | Colore barra progresso parziale |
|
||||
| transfer_progress_bar_total | Colore barra progresso totale |
|
||||
| transfer_status_hidden | Colore status bar file nascosti |
|
||||
| transfer_status_sorting | Colore status bar ordinamento file; si applica anche al popup ordinamento |
|
||||
| transfer_status_sync_browsing | Colore status bar per sync browsing |
|
||||
|
||||
#### Misc
|
||||
|
||||
Questi stili si applicano a varie componenti dell'applicazione.
|
||||
|
||||
| Key | Description |
|
||||
|-------------------|---------------------------------------------|
|
||||
| misc_error_dialog | Colore dialoghi errore |
|
||||
| misc_info_dialog | Colore per dialoghi informazioni |
|
||||
| misc_input_dialog | Colore per dialoghi input (tipo copia file) |
|
||||
| misc_keys | Colore per abbinamento tasti |
|
||||
| misc_quit_dialog | Colore per dialogo quit |
|
||||
| misc_save_dialog | Colore per dialogo salva |
|
||||
| misc_warn_dialog | Colore per dialoghi avvertimento |
|
||||
|
||||
---
|
||||
|
||||
## Editor di testo ✏
|
||||
|
||||
Con termscp puoi anche modificare i file di testo direttamente da terminale, utilizzando il tuo editor preferito.
|
||||
Non importa se il file si trova in locale od in remoto, termscp ti consente di modificare e sincronizzare le modifiche per entrambi.
|
||||
Nel caso il file si trovi su host remoto, il file verrà prima scaricato temporaneamente in locale, modificato e poi nel caso ci siano state modifiche, reinviato in remoto.
|
||||
|
||||
Ricorda: **puoi modificare solo i file testuali**; non puoi modificare i file binari.
|
||||
|
||||
---
|
||||
|
||||
## Logging 🩺
|
||||
|
||||
termscp scrive un file di log per ogni sessione, nel percorso seguente:
|
||||
|
||||
- `$HOME/.config/termscp/termscp.log` su Linux/BSD
|
||||
- `$HOME/Library/Application Support/termscp/termscp.log` su MacOs
|
||||
- `FOLDERID_RoamingAppData\termscp\termscp.log` su Windows
|
||||
|
||||
Il log non viene ruotato, ma viene troncato ad ogni lancio di termscp, quindi se devi riportare un issue, non avviare termscp fino a che non avrai salvato il file di log.
|
||||
I log sono sempre riportati a livello di *trace*, quindi sono piuttosto parlanti.
|
||||
Ho scritto questo FAQ sui log, visto che potresti avere qualche dubbio:
|
||||
|
||||
> Si può ridurre la verbosità?
|
||||
|
||||
No. Il motivo è piuttosto semplice: quando c'è un problema, devi sapere cosa lo sta causando e l'unico modo per farlo e avere il log alla massima verbosità per avere la massima precisione sul controllo del flusso.
|
||||
|
||||
> Se trace è il livello di verbosità, non si raggiungono dimensioni enormi?
|
||||
|
||||
Probabilmente no, a meno che tu tenga sempre termscp acceso. Una lunga sessione potrebbe raggiungere i 10MB di log, ma una sessione media all'incirca 2MB.
|
||||
|
||||
> Non voglio il logging, posso disabilitarlo?
|
||||
|
||||
Sì, puoi. Basta lanciare termscp con `-q or --quiet` come opzione. Puoi mantenerlo persistente salvandolo come alias nella tua shell. Ricorda che i log vengono usati per diagnosticare problemi e considerando che questo è un progetto open-source è anche un modo per contribuire al progetto 😉. Non voglio far sentire in colpa nessuno, ma tanto per dire.
|
||||
|
||||
> Il logging è sicuro?
|
||||
|
||||
Se ti chiedi se il log espone dati sensibili, il log non espone nessuna password o dato sensibile.
|
||||
|
||||
## Notifiche 📫
|
||||
|
||||
termscp invierà notifiche destkop per i seguenti eventi:
|
||||
|
||||
- a **Transferimento completato**: La notifica verrà inviata a seguito di un trasferimento completato.
|
||||
- ❗ La notifica verrà mostrata solo se la dimensione totale del trasferimento è uguale o maggiore al parametro `Notifications: minimum transfer size` definito in configurazione.
|
||||
- a **Transferimento fallito**: La notifica verrà inviata a seguito di un trasferimento fallito.
|
||||
- ❗ La notifica verrà mostrata solo se la dimensione totale del trasferimento è uguale o maggiore al parametro `Notifications: minimum transfer size` definito in configurazione.
|
||||
- ad **Aggiornamento disponibile**: Ogni volta che una nuova versione di termscp è disponibile, verrà mostrata una notifica.
|
||||
- ad **Aggiornamento installato**: Al termine dell'installazione di un aggiornamento, verrà mostrata una notifica.
|
||||
- ad **Aggiornamento fallito**: Al fallimento dell'installazione di un aggiornamento, verrà mostrata una notifica.
|
||||
|
||||
❗ Se vuoi disabilitare le notifiche, è sufficiente andare in configurazione ed impostare `Enable notifications?` a `No` 😉.
|
||||
❗ Se vuoi modificare la soglia minima per le notifiche dei trasferimenti, puoi impostare il valore di `Notifications: minimum transfer size` in configurazione 🙂.
|
||||
15
docs/man.md
15
docs/man.md
|
|
@ -25,7 +25,6 @@
|
|||
- [Transfer page](#transfer-page)
|
||||
- [Misc](#misc)
|
||||
- [Text Editor ✏](#text-editor-)
|
||||
- [How do I configure the text editor 🦥](#how-do-i-configure-the-text-editor-)
|
||||
- [Logging 🩺](#logging-)
|
||||
- [Notifications 📫](#notifications-)
|
||||
|
||||
|
|
@ -174,7 +173,7 @@ All the actions are available when working with multiple files, but be aware tha
|
|||
### Synchronized browsing ⏲️
|
||||
|
||||
When enabled, synchronized browsing, will allow you to synchronize the navigation between the two panels.
|
||||
This means that whenever you'll change the working directory on one panel, the same action will be reproduced on the other panel. If you want to enable synchronized browsing just press `<Y>`; press twice to disable. While enabled, the synchronized browising state will be reported on the status bar on `ON`.
|
||||
This means that whenever you'll change the working directory on one panel, the same action will be reproduced on the other panel. If you want to enable synchronized browsing just press `<Y>`; press twice to disable. While enabled, the synchronized browsing state will be reported on the status bar on `ON`.
|
||||
|
||||
> ❗ at the moment, whenever you try to access an unexisting directory, you won't be prompted to create it. This might change in a future update.
|
||||
|
||||
|
|
@ -229,7 +228,7 @@ whenever you want to use the previously saved connection, just press `<TAB>` to
|
|||
Sure 😉.
|
||||
As said before, bookmarks are saved in your configuration directory along with passwords. Passwords are obviously not plain text, they are encrypted with **AES-128**. Does this make them safe? Absolutely! (except for BSD and WSL users 😢)
|
||||
|
||||
On **Windows**, **Linux** and **MacOS** the passwords are stored, if possible (but should be), respectively in the *Windows Vault*, in the *system keyring* and into the *Keychain*. This is actually super-safe and is directly managed by your operating system.
|
||||
On **Windows**, **Linux** and **MacOS** the key used to encrypt passwords is stored, if possible (but should be), respectively in the *Windows Vault*, in the *system keyring* and into the *Keychain*. This is actually super-safe and is directly managed by your operating system.
|
||||
|
||||
❗ Please, notice that if you're a Linux user, you'd better to read the [chapter below 👀](#linux-keyring), because the keyring might not be enabled or supported on your system!
|
||||
|
||||
|
|
@ -337,7 +336,7 @@ These are the keys supported by the formatter:
|
|||
- `CTIME`: Creation time (with syntax `%b %d %Y %H:%M`); Extra might be provided as the time syntax (e.g. `{CTIME:8:%H:%M}`)
|
||||
- `GROUP`: Owner group
|
||||
- `MTIME`: Last change time (with syntax `%b %d %Y %H:%M`); Extra might be provided as the time syntax (e.g. `{MTIME:8:%H:%M}`)
|
||||
- `NAME`: File name (Elided if longer than 24)
|
||||
- `NAME`: File name (Elided if longer than LENGTH)
|
||||
- `PEX`: File permissions (UNIX format)
|
||||
- `SIZE`: File size (omitted for directories)
|
||||
- `SYMLINK`: Symlink (if any `-> {FILE_PATH}`)
|
||||
|
|
@ -359,7 +358,7 @@ In order to create your own customization from termscp, all you have to do so is
|
|||
|
||||
Here you can move with `<UP>` and `<DOWN>` to change the style you want to change, as shown in the gif below:
|
||||
|
||||
|
||||
|
||||
|
||||
termscp supports both the traditional explicit hex (`#rrggbb`) and rgb `rgb(r, g, b)` syntax to provide colors, but also **[css colors](https://www.w3schools.com/cssref/css_colors.asp)** (such as `crimson`) are accepted 😉. There is also a special keywork which is `Default`. Default means that the color used will be the default foreground or background color based on the situation (foreground for texts and lines, background for well, guess what).
|
||||
|
||||
|
|
@ -441,10 +440,6 @@ In case the file is located on remote host, the file will be first downloaded in
|
|||
|
||||
Just a reminder: **you can edit only textual file**; binary files are not supported.
|
||||
|
||||
### How do I configure the text editor 🦥
|
||||
|
||||
Text editor is automatically found using this [awesome crate](https://github.com/milkey-mouse/edit), if you want to change the text editor to use, change it in termscp configuration. [Read more](#configuration-️)
|
||||
|
||||
---
|
||||
|
||||
## Logging 🩺
|
||||
|
|
@ -487,5 +482,5 @@ Termscp will send Desktop notifications for these kind of events:
|
|||
- on **Update installed**: Whenever a new version of termscp has been installed, a notification will be displayed.
|
||||
- on **Update failed**: Whenever the installation of the update fails, a notification will be displayed.
|
||||
|
||||
❗ If you prefer to keep notifications turned off, you can just enter setup and set `Enable notifications?` to `No` 😉.
|
||||
❗ If you prefer to keep notifications turned off, you can just enter setup and set `Enable notifications?` to `No` 😉.
|
||||
❗ If you want to change the minimum transfer size to display notifications, you can change the value in the configuration with key `Notifications: minimum transfer size` and set it to whatever suits better for you 🙂.
|
||||
|
|
|
|||
|
|
@ -0,0 +1,243 @@
|
|||
# termscp
|
||||
|
||||
<p align="center">
|
||||
<img src="/assets/images/termscp.svg" width="256" height="256" />
|
||||
</p>
|
||||
|
||||
<p align="center">~ 功能丰富的终端文件传输 ~</p>
|
||||
<p align="center">
|
||||
<a href="https://veeso.github.io/termscp/" target="_blank">网站</a>
|
||||
·
|
||||
<a href="https://veeso.github.io/termscp/#get-started" target="_blank">安装</a>
|
||||
·
|
||||
<a href="https://veeso.github.io/termscp/#user-manual" target="_blank">用户手册</a>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<a href="https://github.com/veeso/termscp"
|
||||
><img
|
||||
height="20"
|
||||
src="/assets/images/flags/us.png"
|
||||
alt="English"
|
||||
/></a>
|
||||
|
||||
<a
|
||||
href="https://github.com/veeso/termscp/blob/main/docs/de/README.md"
|
||||
><img
|
||||
height="20"
|
||||
src="/assets/images/flags/de.png"
|
||||
alt="Deutsch"
|
||||
/></a>
|
||||
|
||||
<a
|
||||
href="https://github.com/veeso/termscp/blob/main/docs/es/README.md"
|
||||
><img
|
||||
height="20"
|
||||
src="/assets/images/flags/es.png"
|
||||
alt="Español"
|
||||
/></a>
|
||||
|
||||
<a
|
||||
href="https://github.com/veeso/termscp/blob/main/docs/fr/README.md"
|
||||
><img
|
||||
height="20"
|
||||
src="/assets/images/flags/fr.png"
|
||||
alt="Français"
|
||||
/></a>
|
||||
|
||||
<a
|
||||
href="https://github.com/veeso/termscp/blob/main/docs/it/README.md"
|
||||
><img
|
||||
height="20"
|
||||
src="/assets/images/flags/it.png"
|
||||
alt="Italiano"
|
||||
/></a>
|
||||
|
||||
<a
|
||||
href="https://github.com/veeso/termscp/blob/main/docs/zh-CN/README.md"
|
||||
><img
|
||||
height="20"
|
||||
src="/assets/images/flags/cn.png"
|
||||
alt="简体中文"
|
||||
/></a>
|
||||
</p>
|
||||
|
||||
<p align="center">由 <a href="https://veeso.github.io/">@veeso</a> 开发</p>
|
||||
<p align="center">当前版本： 0.7.0 (12/10/2021)</p>
|
||||
|
||||
[](https://opensource.org/licenses/MIT) [](https://github.com/veeso/termscp) [](https://crates.io/crates/termscp) [](https://crates.io/crates/termscp)
|
||||
|
||||
[](https://github.com/veeso/termscp/actions) [](https://github.com/veeso/termscp/actions) [](https://github.com/veeso/termscp/actions) [](https://github.com/veeso/termscp/actions) [](https://coveralls.io/github/veeso/termscp) [](https://docs.rs/termscp)
|
||||
|
||||
---
|
||||
|
||||
## 关于 termscp 🖥
|
||||
|
||||
termscp 是一个功能丰富的终端文件传输和浏览器，支持 SCP/SFTP/FTP/S3。 所以基本上是一个带有 TUI 的终端实用程序，用于连接到远程服务器以检索和上传文件并与本地文件系统进行交互。
|
||||
它与 **Linux**、**MacOS**、**FreeBSD** 和 **Windows** 兼容。
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Features 🎁
|
||||
|
||||
- 📁 不同的通讯协议
|
||||
- **SFTP**
|
||||
- **SCP**
|
||||
- **FTP** and **FTPS**
|
||||
- **Aws S3**
|
||||
- 🖥 使用方便的 UI 在远程和本地机器文件系统上探索和操作
|
||||
- 创建、删除、重命名、搜索、查看和编辑文件
|
||||
- ⭐ 通过内置书签和最近的连接连接到您最喜欢的主机
|
||||
- 📝 使用您喜欢的应用程序查看和编辑文件
|
||||
- 💁 使用 SSH 密钥和用户名/密码进行 SFTP/SCP 身份验证
|
||||
- 🐧 与 Windows、Linux、FreeBSD 和 MacOS 兼容
|
||||
- 🎨 让它成为你的！
|
||||
- 主题
|
||||
- 自定义文件浏览器格式
|
||||
- 可定制的文本编辑器
|
||||
- 可定制的文件排序
|
||||
- 和许多其他参数...
|
||||
- 📫 传输大文件时通过桌面通知获得通知
|
||||
- 🔐 将密码保存在操作系统密钥保管库中
|
||||
- 🦀 Rust 动力
|
||||
- 👀 开发时注意性能
|
||||
- 🦄 频繁的精彩更新
|
||||
|
||||
---
|
||||
|
||||
## 开始 🚀
|
||||
|
||||
如果您正在考虑安装termscp，我要感谢您💜！ 我希望你会喜欢termscp！
|
||||
如果您想为此项目做出贡献，请不要忘记查看我们的贡献指南。 [阅读更多](../../CONTRIBUTING.md)
|
||||
|
||||
如果您是 Linux、FreeBSD 或 MacOS 用户，这个简单的 shell 脚本将使用单个命令在您的系统上安装 termscp：
|
||||
|
||||
```sh
|
||||
curl --proto '=https' --tlsv1.2 -sSLf "https://git.io/JBhDb" | sh
|
||||
```
|
||||
|
||||
如果您是 Windows 用户，则可以使用 [Chocolatey](https://chocolatey.org/) 安装 termscp：
|
||||
|
||||
```sh
|
||||
choco install termscp
|
||||
```
|
||||
|
||||
如需更多信息或其他平台，请访问 [veeso.github.io](https://veeso.github.io/termscp/#get-started) 查看所有安装方法。
|
||||
|
||||
⚠️ 如果您正在寻找如何更新 termscp 只需从 CLI 运行 termscp ： `(sudo) termscp --update` ⚠️
|
||||
|
||||
### 要求 ❗
|
||||
|
||||
- **Linux** 用户:
|
||||
- libssh
|
||||
- libdbus-1
|
||||
- pkg-config
|
||||
- **FreeBSD** 用户:
|
||||
- libssh
|
||||
- dbus
|
||||
- pkgconf
|
||||
|
||||
### 可选要求 ✔️
|
||||
|
||||
这些要求不是运行 termscp 的强制要求，而是要享受它的所有功能
|
||||
|
||||
- **Linux/FreeBSD** 用户:
|
||||
- 用 `V` **打开** 文件（至少其中之一）
|
||||
- *xdg-open*
|
||||
- *gio*
|
||||
- *gnome-open*
|
||||
- *kde-open*
|
||||
- **Linux** 用户:
|
||||
- keyring manager: [在用户手册中阅读更多内容](man.md#linux-keyring)
|
||||
- **WSL** 用户
|
||||
- 用 `V` **打开** 文件（至少其中之一）
|
||||
- [wslu](https://github.com/wslutilities/wslu)
|
||||
|
||||
---
|
||||
|
||||
## 支持我 ☕
|
||||
|
||||
如果您喜欢 termscp 并且希望看到该项目不断发展和改进，请考虑在**给我买杯咖啡**上捐款以支持我**🥳
|
||||
|
||||
[](https://www.buymeacoffee.com/veeso)
|
||||
|
||||
---
|
||||
|
||||
## 用户手册和文档 📚
|
||||
|
||||
用户手册可以在[termscp的网站](https://veeso.github.io/termscp/#user-manual)上找到 或者在[Github](man.md)上。
|
||||
|
||||
开发者文档可以在 <https://docs.rs/termscp> 的 Rust Docs 上找到。
|
||||
|
||||
---
|
||||
|
||||
## 已知的问题 🧻
|
||||
|
||||
- `NoSuchFileOrDirectory` 连接时 (WSL1): 我知道这个问题，我猜这是 WSL 的一个小故障。 别担心，只需将 termscp 可执行文件移动到另一个 PATH 位置，例如`/usr/bin`，或者通过适当的包格式（例如 deb）安装它。
|
||||
|
||||
---
|
||||
|
||||
## 贡献和问题 🤝🏻
|
||||
|
||||
欢迎贡献、错误报告、新功能和问题！ 😉
|
||||
如果您有任何问题或疑虑，或者您想建议新功能，或者您只想改进termscp，请随时打开问题或 PR。
|
||||
|
||||
请遵循 [我们的贡献指南](../../CONTRIBUTING.md)
|
||||
|
||||
---
|
||||
|
||||
## 变更日志 ⏳
|
||||
|
||||
查看termscp的更新日志 [这里](../../CHANGELOG.md)
|
||||
|
||||
---
|
||||
|
||||
## Powered by 💪
|
||||
|
||||
termscp 由这些很棒的项目提供支持：
|
||||
|
||||
- [bytesize](https://github.com/hyunsik/bytesize)
|
||||
- [crossterm](https://github.com/crossterm-rs/crossterm)
|
||||
- [edit](https://github.com/milkey-mouse/edit)
|
||||
- [keyring-rs](https://github.com/hwchen/keyring-rs)
|
||||
- [open-rs](https://github.com/Byron/open-rs)
|
||||
- [rpassword](https://github.com/conradkleinespel/rpassword)
|
||||
- [rust-s3](https://github.com/durch/rust-s3)
|
||||
- [self_update](https://github.com/jaemk/self_update)
|
||||
- [ssh2-rs](https://github.com/alexcrichton/ssh2-rs)
|
||||
- [suppaftp](https://github.com/veeso/suppaftp)
|
||||
- [textwrap](https://github.com/mgeisler/textwrap)
|
||||
- [tui-rs](https://github.com/fdehau/tui-rs)
|
||||
- [tui-realm](https://github.com/veeso/tui-realm)
|
||||
- [whoami](https://github.com/libcala/whoami)
|
||||
- [wildmatch](https://github.com/becheran/wildmatch)
|
||||
|
||||
---
|
||||
|
||||
## 画廊 🎬
|
||||
|
||||
> 家
|
||||
|
||||
|
||||
|
||||
> 书签
|
||||
|
||||
|
||||
|
||||
> 设置
|
||||
|
||||
|
||||
|
||||
> 文本编辑器
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 执照 📃
|
||||
|
||||
“termscp”在 MIT 许可下获得许可。
|
||||
|
||||
您可以阅读整个许可证 [这里](../../LICENSE)
|
||||
|
|
@ -13,7 +13,7 @@
|
|||
- [书签](#书签)
|
||||
- [我的密码安全吗？](#我的密码安全吗)
|
||||
- [Linux Keyring](#linux-keyring)
|
||||
- [用于 termcp 的 KeepassXC 设置](#用于-termcp-的-keepassxc-设置)
|
||||
- [用于 termscp 的 KeepassXC 设置](#用于-termscp-的-keepassxc-设置)
|
||||
- [Aws S3 凭证](#aws-s3-凭证)
|
||||
- [配置](#配置)
|
||||
- [SSH Key Storage](#ssh-key-storage)
|
||||
|
|
@ -25,7 +25,6 @@
|
|||
- [文件传输页](#文件传输页)
|
||||
- [Misc](#misc)
|
||||
- [文本编辑器](#文本编辑器)
|
||||
- [如何配置文本编辑器？](#如何配置文本编辑器)
|
||||
- [日志](#日志)
|
||||
- [通知](#通知)
|
||||
|
||||
|
|
@ -237,7 +236,7 @@ termscp中的文件资源管理器是指你与远程建立连接后可以看到
|
|||
- ❗对于其他桌面环境的用户，有一个很好的程序，你可以用它来获得钥匙串，这就是[KeepassXC](https://keepassxc.org/)，我在我的Manjaro中使用它（带KDE），一切都很正常。唯一的问题是，你必须设置它与termscp一起使用（但这很简单）。要开始使用KeepassXC，请阅读更多[这里]（#keepassxc-setup-for-termscp）。
|
||||
- ❗如果你不想安装任何这些服务呢？好吧，这没有问题! **termscp依然能正常工作**，但它会将密钥保存在一个文件中，就像它通常为BSD和WSL做的那样。
|
||||
|
||||
##### 用于 termcp 的 KeepassXC 设置
|
||||
##### 用于 termscp 的 KeepassXC 设置
|
||||
|
||||
参照以下步骤，为termscp配置keepassXC：
|
||||
|
||||
|
|
@ -330,7 +329,7 @@ termscp和书签一样，只需要保证这些路径是可访问的：
|
|||
- `CTIME`: 创建时间（语法为`%b %d %Y %H:%M`）；Extra参数可以指定时间显示语法（例如：`{CTIME:8:%H:%M}`）
|
||||
- `GROUP`: 所属组
|
||||
- `MTIME`: 最后修改时间（语法为`%b %d %Y %H:%M`）；Extra参数可以指定时间显示语法（例如：`{MTIME:8:%H:%M}`）
|
||||
- `NAME`: 文件名（超过24个字符的部分会被省略）
|
||||
- `NAME`: 文件名（超过 LENGTH 个字符的部分会被省略）
|
||||
- `PEX`: 文件权限（UNIX格式）
|
||||
- `SIZE`: 文件大小（目录不显示）
|
||||
- `SYMLINK`: 超链接（如果存在的话`-> {FILE_PATH}`）。
|
||||
|
|
@ -352,7 +351,7 @@ Termscp为你提供了一个很棒的功能：可以为应用程序中的几个
|
|||
|
||||
在这里你可以用`<UP>`和`<DOWN>`移动来选择你想改变的样式，如下图所示：
|
||||
|
||||
|
||||
|
||||
|
||||
termscp支持传统的十六进制（`#rrggbb`）和RGB`rgb(r, g, b)`语法来表示颜色，但也接受 **[css颜色](https://www.w3schools.com/cssref/css_colors.asp)**（如`crimson`）😉。还有一个特殊的关键词是`Default`，意味着使用的颜色将是基于情景的默认前景或背景颜色（文本和线条的前景色，以及容器的背景色，你猜是什么）。
|
||||
|
||||
|
|
@ -434,10 +433,6 @@ Termscp有很多功能，你可能已经注意到了，其中之一就是可以
|
|||
|
||||
多说一句，**你只能编辑文本文件**；二进制文件是不可以的。
|
||||
|
||||
### 如何配置文本编辑器？
|
||||
|
||||
文本编辑器是通过[awesome crate](https://github.com/milkey-mouse/edit)自动查找的，如果你想改变默认的文本编辑器，请在termscp配置中改变它。[阅读更多](#配置)
|
||||
|
||||
---
|
||||
|
||||
## 日志
|
||||
|
|
@ -478,5 +473,5 @@ termscp 将针对这些类型的事件发送桌面通知：
|
|||
- **更新已安装**：每当安装了新版本的termscp 时，都会显示通知。
|
||||
- **更新失败**：每当更新安装失败时，都会显示通知。
|
||||
|
||||
❗ 如果您希望保持关闭通知，您只需进入设置并将 `Enable notifications?` 设置为 `No`😉。
|
||||
❗ 如果您希望保持关闭通知，您只需进入设置并将 `Enable notifications?` 设置为 `No`😉。
|
||||
❗ 如果您想更改最小传输大小以显示通知，您可以使用键 `Notifications: minimum transfer size` 更改配置中的值，并将其设置为更适合您的任何值🙂。
|
||||
|
|
|
|||
Loading…
Reference in a new issue