English | Español
Modular SSH connection and SCP/RSync transfer manager written in Bash. Delegates SSH options to native OpenSSH (~/.ssh/config); only the configured user and an explicit port are passed on the command line.
- SSH connection (SSH options such as timeouts, keepalive, compression, multiplexing and host-key verification come from
~/.ssh/config; sendorbit passes only the user and, when configured, the port) - SCP and RSync transfers; RSync adds automatic backup of overwritten remote files (native
rsync --backup --backup-dir, aborts if the backup directory cannot be created) - Anti-injection input validation on every entry point: users, hosts, ports (
validate_port) and destinations (validate_folder_path) - Robust interactive input: menus survive EOF (Ctrl-D) and prompt timeouts; confirmations fail safe (cancel)
- Dual logging (general
600+ security) with 10 MiB rotation (current file + 5 rotated),umask 077at startup, logs directory forced to700 - Configurable colors via
R/G/Y/B/NCenvironment overrides - Lock file via
flockover a file descriptor; degrades gracefully ifflockis unavailable - Config parser uses text-only extraction — no
source/evalon user config - PATH sanitized before resolving binaries
- 242 BATS unit tests + CI on push and PR to main
English:
This project was developed with assistance from artificial intelligence tools. Given the automated nature of some components, users are advised to review and test the code independently before integrating it into their own systems.
Español:
Este proyecto fue desarrollado con asistencia de herramientas de inteligencia artificial. Dada la naturaleza automatizada de algunos componentes, se recomienda que los usuarios revisen y prueben el código independientemente antes de integrarlo en sus propios sistemas.
- Bash 4.3+
ssh,scp,rsync- bats (optional, for running the test suite)
git clone https://github.com/morphilab/sendorbit.git
cd sendorbit
cp config/example_hosts.conf config/hosts.conf
chmod 600 config/hosts.conf
# edit config/hosts.conf with your servers
./sendorbit.sh-
Configure your hosts:
cp config/example_hosts.conf config/hosts.conf chmod 600 config/hosts.conf $EDITOR config/hosts.conf -
Run interactively:
./sendorbit.sh
-
Check version or help (
--version|-v,--help|-h):./sendorbit.sh --version ./sendorbit.sh --help
$ ./sendorbit.sh
╔════════════════════════════════════════════╗
║ sendorbit vX.Y.Z ║
╚════════════════════════════════════════════╝
Available hosts:
1. admin@1xx.1xx.1.1xx:22 -> /home/admin/backups
2. deploy@prod-web:2222 -> /var/www/app
3. ops@files.example.com:22 -> /home/ops/files
Host (1-3) or 'q' to quit: 2
SELECTED HOST
User : deploy
Host : prod-web:2222
Destination: /var/www/app
Available actions:
1. Connect SSH
2. Send files (SCP)
3. Smart sync (RSync + automatic backup)
4. View system logs
5. Exit
Select action (1-5): 1
Connect to deploy@prod-web:2222? (y/N): y
Connecting to deploy@prod-web:2222...
[...SSH session...]
Connection closed successfully
The interactive menu ("Send files (SCP)" / "Smart sync") asks for a space-separated list of filenames. Because that input is split on spaces, the TUI does not support filenames containing spaces: if the whole line you type names a single existing file that has spaces, sendorbit aborts with an error instead of silently transferring the name's parts. Use the non-interactive --transfer flag for such files:
./sendorbit.sh --transfer scp deploy prod-web 2222 /var/www/app "my file.txt"# 3 fields: user host folder (SSH default port, usually 22)
"admin 1xx.1xx.1.1xx backups"
# 4 fields: user host folder port
"admin server.com /home/admin/deploy 2222"host accepts IPs, DNS hostnames, or ~/.ssh/config aliases. sendorbit passes the user as user@host, so it overrides the alias's User; set it to the same user. If the port is omitted, the alias's Port is used; an explicit port overrides it.
- SSH options come from
~/.ssh/config; sendorbit only passes the configured user and, when set, the port (an omitted port lets SSH resolve it, including an alias'sPort) - Hosts rejected if they contain shell metacharacters (
;&|<>,(){},`,$,!,',[],*,?,~, newlines, tabs, carriage returns) or path traversal (..) - Ports validated when provided (
1–65535, digits only, no leading zeros), hostnames capped at 253 characters (RFC 1035,validate_hostname), and destinations checked against traversal/metacharacters at every entry point — TUI, CLI and modules - Transfers protected by anti-argument-injection delimiter
-- - Remote backup directory created via
%q-quotedmkdir -p; transfer aborts if the backup cannot be prepared (no silent data loss) - Config parser extracts entries text-only (no
source/execof user-supplied data) - PATH sanitized to
/usr/local/bin:/usr/bin:/binbefore binary resolution - Lock file via
flock -nover a file descriptor; the lockfile is never unlinked at exit (avoids flock-unlink races) - Logs written with
umask 077; general log forced to600(contains usernames, hosts and paths); logs directory forced to700 - Security log with 600 permissions, audit trail of all connection attempts
- No eval, no dynamic source from user input
See SECURITY.md for the full policy.
sendorbit passes only the configured user and, when set, the port; it does not inject any other SSH options. To configure timeouts, keepalive, compression, host-key verification, or ProxyJump, edit ~/.ssh/config:
Host prod-web
HostName 203.0.113.50
User deploy
Port 2222
IdentityFile ~/.ssh/id_ed25519
ConnectTimeout 30
ServerAliveInterval 60
StrictHostKeyChecking accept-newPassphrase-protected keys work if loaded in ssh-agent. Without an agent, SSH will prompt interactively for the passphrase.
Command override scope: SSH_CMD / SCP_CMD / RSYNC_CMD environment presets are honored only when invoking modules/*.sh directly. The main ./sendorbit.sh entrypoint always resolves binaries from its sanitized PATH (/usr/local/bin:/usr/bin:/bin) and ignores those presets — intentional, so production runs never execute wrappers inherited from the ambient environment.
README.md → English README (default)
README.es.md → Spanish README
sendorbit.sh → entrypoint (interactive TUI + non-interactive CLI)
lib/utils.sh → utilities, colors, output, parsing
lib/validation.sh → centralized validations (no source/exec)
lib/logging.sh → logging with rotation
lib/security.sh → input validation, security logging
modules/connection.sh → SSH connection
modules/transfer.sh → SCP/RSync with native rsync backup
config/ → hosts.conf (gitignored)
logs/ → sendorbit.log, security.log, lock file (gitignored)
tests/ → bats unit tests
SECURITY.md → reporting policy and security model
bats tests/validation_test.sh
bats tests/security_test.sh
bats tests/logging_test.sh
bats tests/modules_test.sh
bats tests/push_dir_test.sh
bats tests/utils_test.sh
bats tests/cli_test.shOr run all suites at once:
bats tests/*.shCI runs bash -n, ShellCheck, and the full BATS suite on push and PR to main.
MIT — Copyright (c) 2026 morphilab