ls-interactive 💻

Interactive ls command made in rust

⚡ Features

🌟 Navigate between folders/files using arrow keys

🌟 Browse folders / Open files with native apps using Enter

🌟 Open folder in terminal (CD to folder) using Shift+Enter or Alt+Enter

🌟 Open folder in file manager using Ctrl+Enter

🌟 Type anything to filter current folder content using fuzzy search

🌟 Top button (📁 ..) opens the parent directory (LeftArrow can also be used when fuzzy text field is empty)

🌟 Press Esc to exit

on Linux/Mac Shift+Enter or Ctrl+Enter might not work

see crossterm-rs/crossterm#669

🛠 Installation

Download zip package from releases page
Extract its content into a folder in PATH (guide)
Follow shell specific instructions:

Bash (Linux/Mac) or Zsh

Copy the lsi function from scripts/lsi.sh to your ~/.bashrc or ~/.zshrc file:

ls-interactive/scripts/lsi.sh

Lines 3 to 8 in f1cd2db

    
           lsi() { 
        
             local output 
        
             if output=$(ls-interactive "$@") && [[ $output ]] ; then 
        
               cd "$output" 
        
             fi 
        
           }

Batch (Windows CMD)

Copy scripts/lsi.bat into a folder that is in your %PATH% environment variable

ls-interactive/scripts/lsi.bat

Lines 3 to 5 in f1cd2db

    
           @echo off 
        
           for /f "tokens=*" %%i in ('%~dp0\ls-interactive.exe "%*"') do set output=%%i 
        
           IF DEFINED output cd %output%

you can open you environment variables settings using the command below: (or by searching for env in the start menu)

rundll32.exe sysdm.cpl,EditEnvironmentVariables

Fish Shell

Copy scripts/lsi.fish into ~/.config/fish/functions/

OR copy the function inside into your ~/.config/fish/config.fish file

ls-interactive/scripts/lsi.fish

Lines 7 to 13 in f1cd2db

    
           function lsi 
        
               set -l output (ls-interactive "$argv") 
        
               if test $status -eq 0 
        
                   and test -n "$output" 
        
                   cd $output 
        
               end 
        
           end

Powershell

Copy the lsi function from scripts/lsi.ps1 to your Microsoft.PowerShell_profile.ps1

ls-interactive/scripts/lsi.ps1

Lines 7 to 10 in f1cd2db

    
           function lsi { 
        
               $output = (ls-interactive "$args") 
        
               if ($output) { Set-Location $output } 
        
           }

you can open your profile using one of the following commands:

notepad $profile

gedit $profile

Nushell

Copy the lsi function from scripts/lsi.nu to your env.nu

ls-interactive/scripts/lsi.nu

Lines 4 to 10 in f6d2fd2

    
           def-env lsi [...path: string] { 
        
               let output = (ls-interactive ($path | str join ' ')) 
        
               cd ( 
        
                   if ($output | is-empty) { $env.PWD }  
        
                   else { $output } 
        
               ) 
        
           }

you can open your environment file using the following command:

config env

💻 How to run it

lsi

or

lsi some_relative_path

⚙️ Build it yourself

(Releases are automatically built by github actions)

install rust
clone/download the repo
run in project directory:
- cargo run: to run in dev mode
- cargo build --release: to build locally,
  - executable will be in /target/release and named ls_interactive
  - launch script will be in the /scripts directory

🤝Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page.

Before submitting a Pull Request, verify your changes with all following commands:

cargo check

cargo fmt --all --check

cargo clippy --all-targets --all-features -- -W clippy::pedantic -W clippy::cargo -W clippy::nursery

❤️ Show your support

Give a ⭐ if this package helped you!

📜 License

MIT. See LICENSE file for details.

Name		Name	Last commit message	Last commit date
Latest commit History 155 Commits
.github		.github
scripts		scripts
src		src
.gitignore		.gitignore
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
LICENSE		LICENSE
README.md		README.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

ls-interactive 💻

⚡ Features

🛠 Installation

💻 How to run it

⚙️ Build it yourself

🤝Contributing

❤️ Show your support

📜 License

About

Uh oh!

Releases 11

Packages

Uh oh!

Contributors 2

Uh oh!

Languages

	lsi() {
	local output
	if output=$(ls-interactive "$@") && [[ $output ]] ; then
	cd "$output"
	fi
	}

	@echo off
	for /f "tokens=" %%i in ('%~dp0\ls-interactive.exe "%"') do set output=%%i
	IF DEFINED output cd %output%

	function lsi
	set -l output (ls-interactive "$argv")
	if test $status -eq 0
	and test -n "$output"
	cd $output
	end
	end

	function lsi {
	$output = (ls-interactive "$args")
	if ($output) { Set-Location $output }
	}

	def-env lsi [...path: string] {
	let output = (ls-interactive ($path \| str join ' '))
	cd (
	if ($output \| is-empty) { $env.PWD }
	else { $output }
	)
	}

License

Araxeus/ls-interactive

Folders and files

Latest commit

History

Repository files navigation

ls-interactive 💻

⚡ Features

🛠 Installation

💻 How to run it

⚙️ Build it yourself

🤝Contributing

❤️ Show your support

📜 License

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 11

Packages 0

Uh oh!

Contributors 2

Uh oh!

Languages

Packages