MimixBox packs many Unix commands into a single binary, like BusyBox. Unlike BusyBox, it targets the desktop environment rather than embedded systems. The project aims for a wide range of built-in commands (applets), from the basics provided by Coreutils to its own experimental commands.
The list below is generated from the registered applets by make command-list, so it never drifts from the binary. You can also run mimixbox --list to print it on the terminal.
There are 451 commands. Run mimixbox --list to see them on the terminal.
| Command | Description |
|---|---|
| [ | Evaluate a conditional expression (test alias requiring ]) |
| [[ | Evaluate a conditional expression (test alias requiring ]]) |
| acpid | Dispatch ACPI events (foreground) |
| add-shell | Add shell name to /etc/shells |
| addgroup | Add a group to /etc/group |
| adduser | Create a user account |
| adjtimex | Read or set kernel clock parameters |
| ar | Create, modify and extract from archives |
| arch | Print machine hardware name (same as uname -m) |
| arp | Show the ARP/neighbour cache (read-only) |
| arping | Probe a host on the local network with ARP requests |
| ascii | Print the ASCII code table |
| ash | Command interpreter (MimixBox mbsh compatibility front-end) |
| awk | Pattern scanning and processing language |
| banner | Print a string as large ASCII-art letters |
| base32 | Base32 encode/decode from FILE(or STDIN) to STDOUT |
| base64 | Base64 encode/decode from FILE(or STDIN) to STDOUT |
| basename | Print basename (PATH without "/") from file path |
| bash | Command interpreter (MimixBox mbsh compatibility front-end) |
| bbconfig | Print the MimixBox build configuration |
| bc | An arbitrary-precision calculator language |
| beep | Sound the console speaker |
| blkdiscard | Discard sectors on a block device |
| blkid | Identify the filesystem type of a device or image |
| blockdev | Report block device properties |
| bootchartd | Collect a bootchart performance sample |
| brctl | Manage Ethernet bridges (capability-gated) |
| bunzip2 | Decompress bzip2 (.bz2) files |
| busybox | BusyBox-style multi-call front-end for MimixBox applets |
| bzcat | Decompress bz2 data to standard output |
| bzip2 | Compress or decompress files (.bz2) |
| cal | Display a calendar |
| cat | Concatenate files and print on the standard output |
| chat | Run an expect/send conversation script |
| chattr | Change ext2/ext4 file attributes |
| chcon | Change the SELinux security context of files (privileged) |
| chgrp | Change the group of each FILE to GROUP |
| chmod | Change file mode bits |
| chown | Change the owner and/or group of each FILE to OWNER and/or GROUP |
| chpasswd | Update passwords in batch |
| chpst | Run a program with a changed process state |
| chroot | Run command or interactive shell with special root directory |
| chrt | Get or set a process's real-time scheduling attributes |
| chsh | Change a user's login shell |
| chvt | Switch to a virtual terminal |
| cksum | Print CRC checksum and byte count of each file |
| clear | Clear terminal |
| cmatrix | Show the falling-glyph digital rain effect |
| cmp | Compare two files byte by byte |
| comm | Compare two sorted files line by line |
| compress | Compress files with LZW (.Z) |
| conspy | Remotely view a virtual console |
| cowsay | Print message with cow's ASCII art |
| cowthink | Print message in a cow's thought bubble |
| cp | Copy file(s) to Directory(s) |
| cpio | Copy files to and from archives |
| crc32 | Print the CRC-32 checksum of each file |
| crond | Run scheduled cron jobs (foreground) |
| crontab | Maintain a user's crontab |
| cryptpw | Crypt-hash a password from stdin |
| cttyhack | Run PROGRAM with the current stdio (no controlling-TTY trick) |
| cut | Remove sections from each line of files |
| date | Print or set the system date and time |
| dc | Reverse-Polish (stack) desk calculator |
| dd | Convert and copy a file |
| deallocvt | Deallocate a virtual terminal |
| delgroup | Remove a group from /etc/group |
| deluser | Remove a user account |
| depmod | Build the module dependency list |
| devmem | Read or write physical memory |
| df | Report file system disk space usage |
| dhcprelay | Relay DHCP requests between networks |
| diff | Compare files line by line |
| dirname | Print only directory path |
| dmesg | Print or control the kernel ring buffer |
| dnsd | Tiny authoritative DNS server for a hosts file |
| dnsdomainname | Show the DNS domain name |
| dos2unix | Change CRLF to LF |
| dpkg | Inspect and unpack local Debian .deb files |
| dpkg-deb | Inspect and extract Debian .deb archives |
| du | Estimate file space usage |
| dumpkmap | Dump the console keymap in binary form |
| dumpleases | Display DHCP server leases |
| echo | Display a line of text |
| ed | A line-oriented text editor |
| egrep | Search with extended regular expressions (grep -E) |
| eject | Eject removable media |
| env | Run a program in a modified environment / print the environment |
| envdir | Run a program with env from a directory |
| envuidgid | Run a program with $UID/$GID from a user |
| ether-wake | Send a Wake-on-LAN magic packet to a MAC address |
| expand | Convert TAB to N space (default:N=8) |
| expr | Evaluate expressions |
| factor | Print the prime factors of each NUMBER |
| fakeidentd | Answer ident (RFC 1413) queries with a fixed user |
| fakemovie | Adds a video playback button to the image |
| fallocate | Preallocate or extend space for a file |
| false | Do nothing. Return failure(1) |
| fatattr | Show or change FAT file attributes |
| fbset | Show the framebuffer video mode |
| fdflush | Flush a floppy device's buffers |
| fdformat | Low-level format a floppy device |
| fdisk | List the MBR partition table |
| fgconsole | Print the active virtual terminal |
| fgrep | Search for fixed strings (grep -F) |
| find | Search for files in a directory hierarchy |
| findfs | Find a filesystem by label or UUID |
| flock | Run a command under an advisory file lock |
| fmt | Simple optimal text formatter |
| fold | Wrap each input line to fit in specified width |
| fortune | Print a random, hopefully interesting, adage |
| free | Display amount of free and used memory in the system |
| freeramdisk | Free the memory used by a ramdisk |
| fsck | Detect and report a filesystem type |
| fsck.minix | Check a Minix filesystem |
| fsfreeze | Suspend or resume a filesystem |
| fstrim | Discard unused blocks on a filesystem |
| fsync | Flush a file's data to storage with fsync(2) |
| ftpd | Minimal read-only FTP server (foreground) |
| ftpget | Download a file from an FTP server |
| ftpput | Upload a file to an FTP server |
| fuser | Identify processes using a file |
| getenforce | Print the current SELinux enforcing mode |
| getfattr | Get extended attributes of files |
| getopt | Parse command options (enhanced, like util-linux getopt) |
| getsebool | Show the state of SELinux booleans |
| getty | Prompt for a username and run login |
| ghrdc | GitHub Release Download Counter |
| grep | Print lines that match patterns |
| groups | Print the groups to which USERNAME belongs |
| gunzip | Decompress gzip (.gz) files |
| gzip | Compress or uncompress FILEs (by default, compress FILES in-place) |
| halt | Halt the system |
| hd | Dump a file in canonical hex+ASCII (hexdump -C) |
| head | Print the first NUMBER(default=10) lines |
| hexdump | Display a file in hexadecimal (and other formats) |
| hostid | Print the numeric identifier (in hexadecimal) for the current host |
| hostname | Show the system's host name |
| http-status-code | Explain HTTP status codes and their RFC references |
| httpd | Serve static files over HTTP |
| hush | Command interpreter (MimixBox mbsh compatibility front-end) |
| hwclock | Read the hardware (RTC) clock |
| i2cdetect | Detect I2C chips on a bus |
| i2cdump | Dump the registers of an I2C device |
| i2cget | Read a byte from an I2C device |
| i2cset | Write a byte to an I2C device |
| id | Print User ID and Group ID |
| ifconfig | Show network interface configuration (read-only) |
| ifdown | Take a network interface down |
| ifenslave | Attach/detach bonding slaves (capability-gated) |
| ifplugd | Bring interfaces up/down on link change |
| ifup | Bring a network interface up |
| inetd | Internet super-server (minimal) |
| init | Run an inittab's startup actions |
| inotifyd | Run a handler on file inotify events |
| insmod | Validate and (privileged) insert a kernel module |
| install | Copy files and set attributes |
| ionice | Get or set process I/O scheduling class and priority |
| iostat | Report CPU and device I/O statistics |
| ip | Show and manage routing, devices, and tunnels (read-only show/list) |
| ipaddr | Show protocol (IP) addresses on devices |
| ipcalc | Calculate IP network parameters from an address |
| ipcrm | Remove System V IPC objects by id |
| ipcs | Show System V IPC facilities status |
| iplink | Show network device link state |
| ipneigh | Show the ARP/neighbour table |
| iproute | Show the routing table |
| iprule | Show routing policy rules |
| iptunnel | Show/parse IP tunnels (inspect-only) |
| ischroot | Detect if running in a chroot |
| kbd_mode | Report or set the keyboard mode |
| kill | Kill process or send signal to process |
| killall | Kill processes by name |
| killall5 | Send a signal to all processes |
| klogd | Forward kernel messages to the system log |
| last | Show a listing of last logged-in users |
| leadtime | Calculate GitHub PR lead time statistics |
| less | Page through text one screen at a time |
| lifegame | Life game (Conway's Game of Life) |
| link | Create a hard link to a file |
| linux32 | Run a program with a 32-bit execution domain |
| linux64 | Run a program with a 64-bit execution domain |
| linuxrc | Run an inittab's startup actions |
| ln | Create hard or symbolic link |
| load_policy | Load a new SELinux policy into the kernel (privileged) |
| loadfont | Load a console font from stdin |
| loadkmap | Load a binary console keymap from stdin |
| log-collect | Gather system log files into one directory |
| logger | Write a message to the system log |
| login | Authenticate a user and start their shell |
| logname | Print the name of the current user |
| logread | Show the system log |
| losetup | List active loop devices |
| lpd | Drain the local print spool to an output directory |
| lpq | Show the local print queue |
| lpr | Queue files for printing into a local spool |
| ls | List directory contents |
| lsattr | List ext2/ext4 file attributes |
| lsblk | List information about block devices |
| lsmod | List loaded kernel modules |
| lsof | List open files of processes |
| lspci | List PCI devices |
| lsscsi | List SCSI devices |
| lsusb | List USB devices |
| lzcat | Decompress lzma data to standard output |
| lzma | Compress or decompress files (lzma) |
| lzop | Compress or decompress files (.lzo) |
| lzopcat | Decompress lzop (.lzo) data to standard output |
| makedevs | Create a device tree from a table |
| makemime | Create a MIME-encoded message from files |
| man | Display a manual page |
| matchpathcon | Show the default file context for a path |
| mbsh | Mimix Box Shell |
| md5sum | Calculate or Check md5sum message digest |
| mdev | Create /dev nodes from /sys (scan mode) |
| mesg | Display or control write access to your terminal |
| microcom | Minimal serial terminal program |
| minips | Minimal process lister (PID, user, command) |
| mkdir | Make directories |
| mkdosfs | Create a FAT16 filesystem |
| mke2fs | Create an ext2 filesystem |
| mkfifo | Make FIFO (named pipe) |
| mkfs.ext2 | Create an ext2 filesystem |
| mkfs.minix | Create a Minix filesystem |
| mkfs.reiser | Create a ReiserFS filesystem (unsupported) |
| mkfs.vfat | Create a FAT16 filesystem |
| mknod | Make block or character special files |
| mkpasswd | Compute the crypt hash of a password |
| mkswap | Set up a Linux swap area |
| mktemp | Create a temporary file or directory |
| modinfo | Show information about a kernel module |
| modprobe | Resolve dependencies and (privileged) load a module |
| more | Page through text one screen at a time |
| mount | List the mounted filesystems |
| mountpoint | See if a directory is a mountpoint |
| mpstat | Report per-processor CPU statistics |
| mv | Rename SOURCE to DESTINATION, or move SOURCE(s) to DIRECTORY |
| nameif | Rename network interfaces by MAC (deferred) |
| nbd-client | Attach a network block device (capability-gated) |
| nc | Read and write data across network connections |
| netcat | Read and write data across network connections (alias of nc) |
| netstat | Show network connections and sockets (read-only) |
| nice | Run a command with an adjusted niceness |
| nl | Write each FILE to standard output with line numbers added |
| nmeter | Print system statistics from a format string |
| nohup | Run a command immune to hangups, with output to a non-tty |
| nologin | Refuse a login and exit non-zero |
| nproc | Print the number of processing units available |
| nsenter | Run a program in another process's namespaces |
| nslookup | Query the DNS for a name or address |
| ntpd | NTP client/daemon (query implemented; clock set gated) |
| nyancat | Animate the rainbow-trailing Nyan Cat |
| od | Dump files in octal and other formats |
| openvt | Start a program on a new virtual terminal |
| partprobe | Re-read the partition table of a device |
| passwd | Change a user's password |
| paste | Merge lines of files |
| patch | Apply a diff file to an original |
| path | Manipulate filename path |
| pgrep | Find process IDs by name |
| pidof | Find the process ID of a running program |
| ping | Send ICMP ECHO_REQUEST to network hosts |
| ping6 | Send ICMPv6 ECHO_REQUEST to a host |
| pipe_progress | Copy stdin to stdout, printing progress dots to stderr |
| pivot_root | Change the root filesystem |
| pkill | Signal processes by name |
| pmap | Report the memory map of a process |
| popmaildir | Move messages from a Maildir's new/ directory |
| posixer | Report which POSIX utilities are installed |
| poweroff | Power off the system |
| powertop | Report the system power supplies |
| printenv | Print environment variable |
| printf | Format and print data |
| ps | Report a snapshot of the current processes |
| pscan | Scan a range of TCP ports on a host |
| pstree | Display the process tree |
| pwcrack | Audit crypt(3) password hashes against a wordlist |
| pwd | Print Working Directory |
| pwdx | Print the working directory of a process |
| pwgen | Generate random passwords for authorized testing |
| pwscore | Estimate the strength of a password |
| raidautorun | Auto-detect and start RAID arrays |
| rdate | Get the time from a remote host (RFC 868) |
| rdev | Print the root filesystem device |
| readahead | Preload files into the page cache |
| readlink | Print resolved symbolic links or canonical file names |
| readprofile | Summarize the kernel profiling buffer |
| realpath | Print the resolved absolute file name |
| reboot | Reboot the system |
| reformime | Parse a MIME message and list or extract its parts |
| remove-shell | Remove shell name from /etc/shells |
| renice | Alter the priority of running processes |
| reset | Reset terminal |
| resize | Print commands to set the terminal size |
| restorecon | Restore default SELinux contexts on files (privileged) |
| resume | Resume from a hibernation image |
| rev | Reverse the order of characters in every line |
| rfkill | List or block radio transmitters |
| rm | Remove file(s) or directory(s) |
| rmdir | Remove directory |
| rmmod | Validate and (privileged) remove a kernel module |
| route | Show the IP routing table (read-only) |
| rpm | Query an RPM package file |
| rpm2cpio | Extract the cpio payload from an RPM package |
| rtcwake | Arm the RTC to wake the system |
| run-init | Switch to the real root and run init |
| run-parts | Run all executables in a directory |
| runcon | Run a program in a different SELinux context (privileged) |
| runlevel | Print the previous and current runlevel |
| runsv | Supervise a single service |
| runsvdir | Supervise a directory of services |
| rx | Receive a file with the XMODEM protocol |
| script | Record a command's output to a typescript |
| scriptreplay | Replay a typescript using its timing file |
| sddf | Search & Delete Duplicated File |
| sed | Stream editor for filtering and transforming text |
| seedrng | Seed the RNG from a persistent seed file |
| selinuxenabled | Exit 0 if SELinux is enabled, 1 otherwise |
| sendmail | Deliver a message to a local mbox file |
| seq | Print a column of numbers |
| serial | Rename the file to the name with a serial number |
| sestatus | Show the SELinux status summary |
| setarch | Run a program with a changed architecture personality |
| setconsole | Redirect console output to a device |
| setenforce | Set the SELinux enforcing mode (privileged) |
| setfattr | Set extended attributes of files |
| setfiles | Set file SELinux contexts from a spec file (privileged) |
| setfont | Load a console font from a file |
| setkeycodes | Map scancodes to keycodes |
| setlogcons | Send kernel messages to a VT |
| setpriv | Run a program with different privilege settings |
| setsebool | Set the state of an SELinux boolean (privileged) |
| setserial | Get or set serial port configuration |
| setsid | Run a program in a new session |
| setuidgid | Run a program as a user's uid/gid |
| sh | Command interpreter (MimixBox mbsh compatibility front-end) |
| sha1sum | Calculate or Check secure hash 1 algorithm |
| sha256sum | Calculate or Check secure hash 256 algorithm |
| sha384sum | Calculate or Check secure hash 384 algorithm |
| sha3sum | Calculate or Check SHA-3 message digest |
| sha512sum | Calculate or Check secure hash 512 algorithm |
| showkey | Report the codes of keys pressed at the console |
| shred | Overwrite a file to hide its contents |
| shuf | Generate a random permutation of input lines |
| sl | Cure your bad habit of mistyping |
| slattach | Attach a serial line as a network interface (deferred) |
| sleep | Pause for NUMBER seconds(minutes, hours, days) |
| smemcap | Capture /proc memory data into a tar for smem |
| softlimit | Run a program under resource limits |
| sort | Sort lines of text files |
| speaker | Read text aloud using an installed TTS engine |
| split | Split a file into pieces |
| sqluv | SQL viewer & query runner for CSV/TSV/LTSV and SQLite |
| ssl_client | Open a TLS connection and pipe stdio |
| ssl_server | Minimal TLS server (foreground) |
| start-stop-daemon | Start or stop a background program |
| stat | Display file or file system status |
| strings | Print printable character sequences in files |
| stty | Print or change terminal line settings |
| su | Run a shell as another user |
| sulogin | Single-user root login |
| sum | Checksum and count the blocks in a file (BSD) |
| sv | Control or query a runit service |
| svc | Send control commands to a service |
| svlogd | Log standard input to a directory |
| svok | Check if a service is supervised |
| swapoff | Disable a swap area |
| swapon | Enable a swap area or list active swaps |
| switch_root | Switch to another root and run init |
| sync | Synchronize cached writes to persistent storage |
| sysctl | Read and write kernel parameters at runtime |
| syslogd | Minimal system logging daemon |
| tac | Print the file contents from the end to the beginning |
| tail | Print the last NUMBER(default=10) lines |
| tar | Archive files (create, list, extract) |
| taskset | Set or get a process's CPU affinity |
| tc | Show/parse traffic control configuration (inspect-only) |
| tcpsvd | Accept TCP connections and run a program for each |
| tee | Read from standard input and write to standard output and files |
| telnet | Connect to a host over TCP (raw, line-oriented) |
| telnetd | Minimal telnet server (foreground) |
| test | Evaluate a conditional expression |
| tftp | Transfer a file with a TFTP server (get/put) |
| tftpd | Read-only TFTP server |
| time | Run a command and report how long it took |
| timeout | Run a command with a time limit |
| top | Display system summary and top processes |
| touch | Update the access and modification times of each FILE to the current time |
| tr | Translate or delete characters |
| traceroute | Trace the route packets take to a host (IPv4) |
| traceroute6 | Trace the route packets take to a host (IPv6) |
| tree | List directory contents in a tree-like format |
| true | Do nothing. Return success(0) |
| truncate | Shrink or extend the size of a file to a given size |
| ts | Timestamp each input line |
| tsort | Topological sort of a directed graph |
| tty | Print the file name of the terminal connected to stdin |
| ttysize | Print the terminal width and height |
| tunctl | Create/delete TUN/TAP devices (capability-gated) |
| tune2fs | Show ext2/ext3/ext4 filesystem parameters |
| udhcpc | DHCP client |
| udhcpc6 | DHCPv6 client |
| udhcpd | DHCP server |
| udpsvd | Accept UDP datagrams and run a program for each |
| uevent | Monitor kernel uevents |
| umount | Unmount a filesystem |
| uname | Print system information |
| uncompress | Decompress LZW (.Z) files |
| unexpand | Convert N space to TAB(default:N=8) |
| uniq | Report or omit repeated lines |
| unit | BusyBox unit-test runner (not shipped by MimixBox) |
| unix2dos | Change LF to CRLF |
| unlink | Remove a single file by calling the unlink function |
| unlzma | Decompress lzma files |
| unlzop | Decompress lzop (.lzo) files |
| unshadow | Combine passwd and shadow files for password auditing |
| unshare | Run a program with unshared namespaces |
| unxz | Decompress xz files |
| unzip | Extract files from a ZIP archive |
| uptime | Tell how long the system has been running |
| users | Print the user names of those currently logged in |
| usleep | Pause for N microseconds |
| uudecode | Decode a uuencoded (or base64) file |
| uuencode | Encode a file for transmission over text channels |
| uuidgen | Print UUID (Universally Unique IDentifier) |
| valid-shell | Verify if /etc/shells is valid |
| vconfig | Manage 802.1q VLAN interfaces (capability-gated) |
| vi | A minimal vi-style screen text editor |
| vlock | Lock the terminal until the password is entered |
| vmstat | Report virtual memory statistics |
| volname | Print the volume name of an ISO 9660 filesystem |
| w | Show who is logged on and a system summary |
| wall | Write a message to all logged-in users |
| watch | Execute a program periodically, showing output fullscreen |
| watchdog | Pet a watchdog timer to prevent a reset |
| wc | Print newline, word, and byte counts for each file |
| wget | The non-interactive network downloader |
| which | Returns the file path which would be executed in the current environment |
| who | Show who is logged on |
| whoami | Print login user name |
| whois | Query a WHOIS server for a domain or IP |
| whris | Show management information for a domain's IP addresses |
| xargs | Build and execute command lines from standard input |
| xxd | Make a hex dump or do the reverse |
| xz | Compress or decompress files (xz) |
| xzcat | Decompress xz data to standard output |
| yes | Output a string repeatedly until killed |
| zcat | Decompress gz data to standard output |
| zcip | Manage IPv4 link-local addresses (capability-gated) |
| zip | Package and compress files into a ZIP archive |
| zip-pwcrack | Recover the password of a ZipCrypto-encrypted archive |
MimixBox targets Linux only. The Release Page distributes a tar.gz archive for linux/amd64 and linux/arm64, plus .deb, .rpm, and .apk packages for the same two architectures. The archive is named mimixbox_<version>_linux_<arch>.tar.gz and extracts into a directory containing the mimixbox binary, LICENSE, README.md, and a self-contained installer.sh (with its libshell.sh helper). For example, on Linux (amd64):
$ tar xf mimixbox_0.39.0_linux_amd64.tar.gz
$ cd mimixbox_0.39.0_linux_amd64
$ sudo ./installer.shThe installer copies the binary to /usr/local/bin and creates a symlink there for each applet. It resolves everything relative to itself, so it needs no Git checkout. If you prefer to do it by hand, just install the binary and let it create the symlinks:
$ sudo install -m 0755 mimixbox /usr/local/bin/
$ sudo mimixbox --install /usr/local/bin$ go install github.com/nao1215/mimixbox/cmd/mimixbox@latest
$ sudo mimixbox --install /usr/local/binMimixBox has its own commands that do not exist in packages like Coreutils.
Add a movie-style play button to an image (based on mattn's fakemovie). Use -o to set the output name, -p for a different button style and -r to set the radius.
$ fakemovie lena.png # writes lena_fake.png
$ fakemovie -p lena.png -o out.pngGitHub Release Downloads Counter: print how many times a repository's release assets were downloaded, via the GitHub API. -a shows the count per release and -t the total across all releases. It uses the unauthenticated API, so it is limited to 60 calls per hour and public repositories only.
$ ghrdc nao1215/mimixbox # latest release
$ ghrdc -t nao1215/mimixbox # all releases (total)Manipulate a filename path: print its absolute form, canonical form, directory, basename or extension.
$ path -a path # absolute path
$ path -b /etc/systemd/pstore.conf # basename -> pstore.conf
$ path -d /etc/ssh/ssh_config # dirname -> /etc/ssh
$ path -e archive.tar.gz # extension -> .gzSearch & Delete Duplicated File: find files with identical content (compared by md5 checksum) and remove the duplicates, keeping the most recent copy. The list of removed files is written to duplicated-file.sddf (change the name with -o).
$ sddf .Rename the files in a directory to a common base name with a serial number, useful for normalizing a directory of images or downloads. Choose the base name with -n, put the number as a prefix (-p, default) or suffix (-s), and preview with -d.
$ serial -n photo . # photo0, photo1, ... in the current directory
$ serial -d -n photo . # dry run: print the renames without applying themThe table below shows the tools used when developing commands in the MimixBox project.
| Tool | Description |
|---|---|
| go-licenses | License management of dependent libraries |
| make | Build, test, release, etc. |
| curl | Install ShellSpec |
| install | Install the MimixBox binary on the system |
| docker | Test MimixBox inside Docker |
| debootstrap | Test MimixBox inside a jail environment |
| shellspec | End-to-end test |
| golangci-lint | Lint Go code |
On a Debian-based distribution (e.g. Debian／Ubuntu／Kali Linux／Raspberry Pi OS), install the tools with:
$ sudo apt install build-essential curl git docker.io debootstrap
$ go install github.com/google/go-licenses@latest
$ curl -fsSL https://github.com/shellspec/shellspec/raw/master/install.sh | sh -s -- --yes$ git clone https://github.com/nao1215/mimixbox.git
$ cd mimixbox
$ make buildCreate a Docker environment:
$ make docker
# Once the image build finishes, you are inside the container.Create a jail environment:
$ sudo apt install debootstrap # If debootstrap is not installed on Ubuntu.
$ make build # Build the mimixbox binary.
$ sudo make jail # Create the jail at /tmp/mimixbox/jail.
$ sudo chroot /tmp/mimixbox/jail /bin/bash # Dive into the jail.
# mimixbox --full-install /usr/local/bin # Install MimixBox commands in the jail.Thanks for taking the time to contribute. See CONTRIBUTING.md for details. Contributions are not limited to development; a GitHub Star is also a motivation to keep developing.
To report a bug or request a feature, please use GitHub Issue. Sponsorship is also welcome.
The MimixBox project is licensed under the Apache License 2.0. It also incorporates portions of third-party code distributed under the MIT License (for example the nc, whris, and fakemovie applets), whose original copyright and license notices are preserved in the corresponding source files.
Thanks goes to these wonderful people (emoji key):
 CHIKAMATSU Naohiro 💻 |
 polynomialspace 💻 |
 Kavya Shukla 💻 |
||||
Add your contributions
|
||||||
This project follows the all-contributors specification. Contributions of any kind welcome!