Transgender.rs

A minimalistic TUI file explorer with minimal dependencies, written by a ranger hater, works on Linux & MacOS.

Quick start

Installation

Arch Linux

transgender is available as a package in the AUR. you can install it using your preferred AUR helper. example:

paru -S transgender

Compiling from source

clone the repo

git clone https://github.com/Sberm/Transgender.rs.git

before compilation, make sure you have rust's environment installed, if not, goto HERE

compile & install

cd Transgender.rs
make
make install

Shell configuration

paste this shell script function into your shell configuration file, its location depends on which shell you use (~/.bashrc, ~/.bash_profile, source ~/.zshrc, ~/.config/fish/config.fish)

eval "$(transgender --sh)"

refresh your shell configuration, or open up a new terminal window

# bash
source ~/.bashrc
# or
source ~/.bash_profile

# zsh
source ~/.zshrc

# fish
source ~/.config/fish/config.fish

launch Transgender.rs with:

ts

Usage

keys	function
hjkl(vim bindings) or arrow keys	scroll/enter/exit a directory
o or <ENTER>	go to directory/open file under cursor
i	go to the current directory (in the left window)
q	quit
/	search
n / N	jump to the next / previous search match
Ctrl + U / Ctrl + D	half pageup / pagedown

To open up a directory with trans

ts /usr/lib/
ts ..
ts /root

Config file

located at

~/.tsrc

if ~/.tsrc doesn't exist, you need to create one

It supports changing the editor (opened with o or ENTER) and the theme.

An example of ~/.tsrc:

# Set your preferred editor
editor = emacs

# Set your preferred theme
theme = dark

Editor

The specified editor will open when o or ENTER is pressed while the cursor is on a file.

The default editor is vi.

Theme

The default theme is lucius.

dark theme:

Other themes:

• trans
• lucius
• acme
• sakura
• vscode

Searching

Now supports >> regular expression <<

Trangender.rs performs a search whenever a key is pressed in search mode

Due to the use of the regex-lite crate, the executable can be a bit bloated ( ~504KB). If you don't need the regular expression feature, simply switch to the vanilla version by checking out to the vanilla branch and building Transgender.rs from there.

git checkout vanilla
make
make install

Uninstallation

if you want to uninstall Transgender.rs

make uninstall

Features:

• File exploration
• Changing directories
• Searching by file name
• Opening files with a preferred editor
• Multiple themes

WHY DID I MAKE TRANS?

In my opinion, Trans is simpler than ranger. Creeping
featurism and growing size have made ranger less
attractive. Additionally, ranger is not a good
software; it is filled with bad designs that irritate
its users.

Todo:

• Tests

• Bash completion

• Read utf-8 input

• Better full-width character handling

• Config file to change text editor(default to vi)