https://github.com/sloweax/bwrapper
Bubblewrap simple frontend
https://github.com/sloweax/bwrapper
bubblewrap sandbox
Last synced: 10 months ago
JSON representation
Bubblewrap simple frontend
- Host: GitHub
- URL: https://github.com/sloweax/bwrapper
- Owner: sloweax
- License: mit
- Created: 2025-08-18T14:53:28.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-18T15:34:39.000Z (10 months ago)
- Last Synced: 2025-08-18T16:28:48.205Z (10 months ago)
- Topics: bubblewrap, sandbox
- Language: Go
- Homepage:
- Size: 7.81 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Example
```sh
# creates a sandbox with just bash + ls + env
bwrapper --elf ls --elf env bash
bash-5.2$ pwd
/
bash-5.2$ ls -l
total 0
drwxr-xr-x 4 1000 1000 340 Aug 18 15:07 dev
drwx------ 2 1000 1000 100 Aug 18 15:07 lib
dr-xr-xr-x 466 65534 65534 0 Aug 18 15:07 proc
drwxr-xr-x 2 1000 1000 40 Aug 18 15:07 tmp
drwx------ 3 1000 1000 60 Aug 18 15:07 usr
bash-5.2$ ls -l /usr/bin/
total 1636
-rwxr-xr-x 1 65534 65534 1414104 Sep 24 2024 bash
-rwxr-xr-x 1 65534 65534 72176 May 25 23:11 env
-rwxr-xr-x 1 65534 65534 182872 May 25 23:11 ls
bash-5.2$ env
PWD=/
SHLVL=1
_=/usr/bin/env
```
# Usage
```
usage: bwrapper [-h] [-v] [-r src dst] [-R path] [-w src dst] [-W path] [-e key[=val]]
[--home src dst] [--elf path] [--network] [--no-auto-bind] [--no-new-session]
[--no-exec] [--wayland] [--pulse] command [args]...
options:
-h, --help shows usage and exits
-v, --verbose
-r src dst binds src to dst with read-only permission
-R path same as -r path path
-w src dst binds src to dst
-W path same as -w path path
-e key[=val] sets the enviroment variable. if val is not present, it
is extracted from the current enviroment
--home src dst creates an isolated home to dst stored in src. src is created
if it does not exists
--elf path parses elf and read-only bind its dependencies
--network enable network
--no-auto-bind do not try to find and bind command dependencies
--no-new-session do not create a new terminal session
--no-exec do not execute command. useful for debugging
--wayland sets basic wayland configuration
--pulse sets basic pulse configuration
command
```