Bushuray-tui

command module
v0.1.8 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 6, 2026 License: MIT Imports: 13 Imported by: 0

README

image

AUR

Bushuray-tui

Bushuray-tui is a keyboard-driven Xray client built for your terminal. It uses Bushuray-core as its back-end and It's written in Go with bubbletea

How to use

Bushuray is currently available on AUR under the name of bushuray-git

For other distrobutions download and extract the latest version from releases section then run

./bushuray

Configuration

Bushuray will create its configuration file in ~/.config/bushuray/config.json with the following template:

{
  "socks-port": 3090,
  "http-port": 3091,
  "test-port-range": {
    "start": 3096,
    "end": 30120
  },
  "no-background": false 
}
  • socks-port: Exposed local socks5 port
  • http-port: Exposed local http port
  • test-port-range: Port range used for profile testing
  • no-background: Whether or not tui should have a background. Use this if you want your own terminal background or you have a transparent terminal

Tun mode

To use tun mode, connect to a profile then press v. Tun mode is experimental at this time but should work. If it doesn't, please create an issue. Running as root raises security concerns for the current version, see this issue.

  • If you are experiencing DNS issues, try setting 8.8.8.8 as your primary DNS. This issue is being tracked here

Thanks to @navidmafi for his help with tun mode issues

Debugging

If something is not working as expected, you can examine debug.log and core-debug.log. For example:

tail -f core-debug.log

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL