unbox

Converts a list of vless:// and hysteria2:// links to a sing-box config file.

Quick start

Here VLESS.txt is a file with vless:// and hysteria2:// links. Unbox will ignore anything else in the file, including other protocols and comments.

unbox -f VLESS.txt

In this example sing-box.tmpl.json is a template sing-box config and sing-box.json is where unbox will put generated config.

unbox -f VLESS.txt -t sing-box.tmpl.json -o sing-box.json

Docker

docker run -it -v /your/local/path:/data \
    aceberg/unbox \
    -f /data/VLESS.txt \
    -t /data/sing-box.tmpl.json \
    -o /data/sing-box.json

Options

Key	Description	Default
-f	Path to file with links	VLESS.txt
-j	Validate and Indent json output (yes/no)	no
-n	Rename tags (yes/no). If yes, will rename tags to tag1, tag2...	no
-o	Path to output file
-t	Path to template sing-box config. Example here. There are only two variables available in template: {{ .Unbox_tags }} and {{ .Unbox_outbounds }}

Install

Docker

There are DockerHub and GitHub images:

docker pull aceberg/unbox

docker pull ghcr.io/aceberg/unbox

Binary

All available binaries are listed in the latest release.
For amd64 there is an apt repo.

Android and Termux

For arm64 there are android and termux.deb files.