SMB support (#184)

* feat: smb client * fix: smb connection * fix: smbclient deps * feat: SMB mentions to user manual * feat: changelog * dlib macos * fix: removed smb support from macos :( * fix: restored libsmbclient build * fix: strange lint message * fix: macos build smb * fix: macos build smb * fix: macos tests * fix: macos lint * feat: SMB windows support * fix: windows tests
2025-12-06 17:15:35 -08:00 · 2023-05-13 15:00:16 +02:00
parent a13663e5e9
commit b7369162d2
54 changed files with 1256 additions and 154 deletions
--- a/docs/de/README.md
+++ b/docs/de/README.md
@@ -137,6 +137,7 @@ Termscp ist ein funktionsreicher Terminal-Dateitransfer und Explorer mit Unterst
  - **SCP**
  - **FTP** und **FTPS**
  - **S3**
+  - **SMB**
 - 🖥  Erkunden und bedienen Sie das Dateisystem der Fernbedienung und des lokalen Computers mit einer praktischen Benutzeroberfläche
  - Erstellen, Entfernen, Umbenennen, Suchen, Anzeigen und Bearbeiten von Dateien
 - ⭐  Verbinden Sie sich über integrierte Lesezeichen und aktuelle Verbindungen mit Ihren Lieblingshosts
@@ -185,10 +186,12 @@ Für weitere Informationen oder andere Plattformen besuchen Sie bitte [termscp.v
  - libssh
  - libdbus-1
  - pkg-config
+  - libsmbclient
 - **FreeBSD** Benutzer:
  - libssh
  - dbus
  - pkgconf
+  - libsmbclient

 ### Optionale Softwareanforderungen ✔️

--- a/docs/de/man.md
+++ b/docs/de/man.md
@@ -4,6 +4,7 @@
  - [Usage ❓](#usage-)
    - [Address argument 🌎](#address-argument-)
      - [AWS S3 address argument](#aws-s3-address-argument)
+      - [SMB address argument](#smb-address-argument)
      - [How Password can be provided 🔐](#how-password-can-be-provided-)
  - [S3 connection parameters](#s3-connection-parameters)
    - [S3 credentials 🦊](#s3-credentials-)
@@ -105,6 +106,22 @@ e.g.
 s3://buckethead@eu-central-1:default:/assets
 ```

+#### SMB address argument
+
+SMB has a different syntax for CLI address argument, which is different whether you're on Windows or other systems:
+
+**Windows** syntax:
+
+```txt
+\\[username@]<server-name>\<share>[\path\...]
+```
+
+**Other systems** syntax:
+
+```txt
+smb://[username@]<server-name>[:port]/<share>[/path/.../]
+```
+
 #### How Password can be provided 🔐

 You have probably noticed, that, when providing the address as argument, there's no way to provide the password.
--- a/docs/es/README.md
+++ b/docs/es/README.md
@@ -137,6 +137,7 @@ Termscp es un explorador y transferencia de archivos de terminal rico en funcion
  - **SCP**
  - **FTP** y **FTPS**
  - **S3**
+  - **SMB**
 - 🖥  Explore y opere en el sistema de archivos de la máquina local y remota con una interfaz de usuario práctica
  - Cree, elimine, cambie el nombre, busque, vea y edite archivos
 - ⭐  Conéctese a sus hosts favoritos y conexiones recientes
@@ -181,14 +182,14 @@ Para obtener más información u otras plataformas, visite [termscp.veeso.dev](h

 ### Requisitos ❗

- Usuarios **Linux**:
-  - libssh
+- **Linux** users:
  - libdbus-1
  - pkg-config
- Usuarios **FreeBSD**:
-  - libssh
+  - libsmbclient
+- **FreeBSD** or, **NetBSD** users:
  - dbus
  - pkgconf
+  - libsmbclient

 ### Requisitos opcionales ✔️

--- a/docs/es/man.md
+++ b/docs/es/man.md
@@ -4,6 +4,7 @@
  - [Uso ❓](#uso-)
    - [Argumento dirección 🌎](#argumento-dirección-)
      - [Argumento dirección por AWS S3](#argumento-dirección-por-aws-s3)
+      - [Argumento dirección por SMB](#argumento-dirección-por-smb)
      - [Cómo se puede proporcionar la contraseña 🔐](#cómo-se-puede-proporcionar-la-contraseña-)
  - [S3 parámetros de conexión](#s3-parámetros-de-conexión)
    - [Credenciales de S3 🦊](#credenciales-de-s3-)
@@ -105,6 +106,22 @@ por ejemplo
 s3://buckethead@eu-central-1:default:/assets
 ```

+#### Argumento dirección por SMB
+
+SMB tiene una sintaxis diferente para el argumento de la dirección CLI, que es diferente si está en Windows u otros sistemas:
+
+**Windows** sintaxis:
+
+```txt
+\\[username@]<server-name>\<share>[\path\...]
+```
+
+**Other systems** sintaxis:
+
+```txt
+smb://[username@]<server-name>[:port]/<share>[/path/.../]
+```
+
 #### Cómo se puede proporcionar la contraseña 🔐

 Probablemente haya notado que, al proporcionar la dirección como argumento, no hay forma de proporcionar la contraseña.
--- a/docs/fr/README.md
+++ b/docs/fr/README.md
@@ -137,6 +137,7 @@ Termscp est un file transfer et explorateur de fichiers de terminal riche en fon
  - **SCP**
  - **FTP** et **FTPS**
  - **S3**
+  - **SMB**
 - 🖥  Explorer et opérer sur le système de fichiers distant et local avec une interface utilisateur pratique.
  - Créer, supprimer, renommer, rechercher, afficher et modifier des fichiers
 - ⭐  Connectez-vous à vos hôtes préférés via des signets et des connexions récentes.
@@ -181,14 +182,14 @@ Pour plus d'informations sur les autres méthodes d'installation, veuillez visit

 ### Requis ❗

- utilisateurs **Linux**:
-  - libssh
+- **Linux** users:
  - libdbus-1
  - pkg-config
- utilisateurs **FreeBSD**:
-  - libssh
+  - libsmbclient
+- **FreeBSD** or, **NetBSD** users:
  - dbus
  - pkgconf
+  - libsmbclient

 ### Requis facultatives ✔️

--- a/docs/fr/man.md
+++ b/docs/fr/man.md
@@ -4,6 +4,7 @@
  - [Usage ❓](#usage-)
    - [Argument d'adresse 🌎](#argument-dadresse-)
      - [Argument d'adresse AWS S3](#argument-dadresse-aws-s3)
+      - [Argument d'adresse SMB](#argument-dadresse-smb)
      - [Comment le mot de passe peut être fourni 🔐](#comment-le-mot-de-passe-peut-être-fourni-)
  - [S3 paramètres de connexion](#s3-paramètres-de-connexion)
    - [Identifiants S3 🦊](#identifiants-s3-)
@@ -103,6 +104,23 @@ e.g.
 s3://buckethead@eu-central-1:default:/assets
 ```

+#### Argument d'adresse SMB
+
+SMB a une syntaxe différente pour l'argument d'adresse CLI, qui est différente que vous soyez sur Windows ou sur d'autres systèmes :
+
+syntaxe **Windows**:
+
+```txt
+\\[username@]<server-name>\<share>[\path\...]
+```
+
+syntaxe **Other systems**:
+
+```txt
+smb://[username@]<server-name>[:port]/<share>[/path/.../]
+```
+
+
 #### Comment le mot de passe peut être fourni 🔐

 Vous avez probablement remarqué que, lorsque vous fournissez l'adresse comme argument, il n'y a aucun moyen de fournir le mot de passe.
--- a/docs/it/README.md
+++ b/docs/it/README.md
@@ -137,6 +137,7 @@ Termscp è un file transfer ed explorer ricco di funzionalità, con supporto a S
  - **SCP**
  - **FTP** and **FTPS**
  - **S3**
+  - **SMB**
 - 🖥  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.
@@ -181,14 +182,14 @@ Per ulteriori informazioni sui metodi di installazione su altre piattaforme, vis

 ### Requisiti ❗

- Utenti **Linux**:
-  - libssh
+- **Linux** users:
  - libdbus-1
  - pkg-config
- Utenti **FreeBSD**:
-  - libssh
+  - libsmbclient
+- **FreeBSD** or, **NetBSD** users:
  - dbus
  - pkgconf
+  - libsmbclient

 ### Requisiti opzionali ✔️

--- a/docs/it/man.md
+++ b/docs/it/man.md
@@ -4,6 +4,7 @@
  - [Argomenti da linea di comando ❓](#argomenti-da-linea-di-comando-)
    - [Argomento indirizzo 🌎](#argomento-indirizzo-)
      - [Argomento indirizzo per AWS S3](#argomento-indirizzo-per-aws-s3)
+      - [Indirizzo SMB](#indirizzo-smb)
      - [Come fornire la password 🔐](#come-fornire-la-password-)
  - [Parametri di connessione S3](#parametri-di-connessione-s3)
    - [Credenziali S3 🦊](#credenziali-s3-)
@@ -101,6 +102,23 @@ e.g.
 s3://buckethead@eu-central-1:default:/assets
 ```

+#### Indirizzo SMB
+
+SMB ha una sintassi differente rispetto agli altri protocolli e cambia in base al sistema operativo:
+
+**Windows**:
+
+```txt
+\\[username@]<server-name>\<share>[\path\...]
+```
+
+**Altri sistemi**:
+
+```txt
+smb://[username@]<server-name>[:port]/<share>[/path/.../]
+```
+
+
 #### Come fornire la password 🔐

 Quando si usa l'argomento indirizzo non è possibile fornire la password direttamente nell'argomento, esistono però altri metodi per farlo:
--- a/docs/man.md
+++ b/docs/man.md
@@ -4,6 +4,7 @@
  - [Usage ❓](#usage-)
    - [Address argument 🌎](#address-argument-)
      - [AWS S3 address argument](#aws-s3-address-argument)
+      - [SMB address argument](#smb-address-argument)
      - [How Password can be provided 🔐](#how-password-can-be-provided-)
  - [S3 connection parameters](#s3-connection-parameters)
    - [S3 credentials 🦊](#s3-credentials-)
@@ -103,6 +104,22 @@ e.g.
 s3://buckethead@eu-central-1:default:/assets
 ```

+#### SMB address argument
+
+SMB has a different syntax for CLI address argument, which is different whether you're on Windows or other systems:
+
+**Windows** syntax:
+
+```txt
+\\[username@]<server-name>\<share>[\path\...]
+```
+
+**Other systems** syntax:
+
+```txt
+smb://[username@]<server-name>[:port]/<share>[/path/.../]
+```
+
 #### How Password can be provided 🔐

 You have probably noticed, that, when providing the address as argument, there's no way to provide the password.
--- a/docs/zh-CN/README.md
+++ b/docs/zh-CN/README.md
@@ -139,6 +139,7 @@ termscp 是一个功能丰富的终端文件浏览和传输工具，支持 SCP/S
  - **SCP**
  - **FTP** and **FTPS**
  - **S3**
+  - **SMB**
 - 🖥  使用便捷的 UI 在远程和本地文件系统上浏览和操作
  - 创建、删除、重命名、搜索、查看和编辑文件
 - ⭐  通过“内置书签”和“最近连接”快速连接到您的主机
@@ -188,10 +189,12 @@ choco install termscp
  - libssh
  - libdbus-1
  - pkg-config
+  - libsmbclient
 - **FreeBSD** 用户:
  - libssh
  - dbus
  - pkgconf
+  - libsmbclient

 ### 可选项 ✔️

--- a/docs/zh-CN/man.md
+++ b/docs/zh-CN/man.md
@@ -4,6 +4,7 @@
  - [用法](#用法)
    - [地址参数](#地址参数)
      - [AWS S3 地址参数](#aws-s3-地址参数)
+      - [SMB 地址参数](#smb-地址参数)
      - [如何输入密码](#如何输入密码)
  - [S3 连接参数](#s3-连接参数)
    - [Aws S3 凭证](#aws-s3-凭证)
@@ -102,6 +103,22 @@ s3://<bucket-name>@<region>[:profile][:/wrkdir]
 s3://buckethead@eu-central-1:default:/assets
 ```

+#### SMB 地址参数
+
+SMB 对 CLI 地址参数有不同的语法，无论您是在 Windows 还是其他系统上，这都是不同的：
+
+**Windows** 句法:
+
+```txt
+\\[username@]<server-name>\<share>[\path\...]
+```
+
+**其他系统** 句法:
+
+```txt
+smb://[username@]<server-name>[:port]/<share>[/path/.../]
+```
+
 #### 如何输入密码

 你可能已经注意到，url参数中没有办法直接附加密码，你可以通过以下三种方式提供密码：