1
0
Fork
You've already forked fb
0
TUI File browser written using textual.
  • Python 93.2%
  • CSS 2.7%
  • Makefile 2.2%
  • Batchfile 1.9%
Gordinator f2427fb720 Clarified admin requirements for Windows install (README) 
Signed-off-by: Gordinator <gordinator@gordinator.org>
2024年06月15日 13:09:47 +01:00
.gitignore Updated .gitignore 2024年06月13日 18:14:28 +01:00
app.css Created address bars 2023年12月25日 21:10:01 +00:00
Compile-Windows.bat Created Windows compilation script 2024年06月11日 13:48:08 +01:00
Install-Windows.bat Added install script 2024年06月15日 13:07:39 +01:00
LICENSE Initial commit 2023年12月25日 18:19:47 +00:00
main.py Added support for pasting 2024年06月15日 12:25:14 +01:00
Makefile Added CC arg to Makefile 2024年06月13日 18:06:12 +01:00
README.md Clarified admin requirements for Windows install (README) 2024年06月15日 13:09:47 +01:00
requirements.txt Add dependency file 2023年12月25日 18:33:51 +00:00
screenshot.svg Updated screenshot 2024年06月13日 18:31:18 +01:00

fb

Screenshot of the app TUI File browser written using textual.

What is it?

fb is a TUI (terminal user interface) program for browsing files. It has two simultaneous panels, an easy-to-use UI, and more.

Why did you make it?

I couldn't find a similar tool. Most terminal-based tools are far too simple or far too complex, and none of them looked nice or familiar enough to meet my needs. So I decided to make my own. Sorry, lf users.

Why 'fb'?

I noticed that a lot of similar tools (lf,nnn, etc.) have 2-letter names for simplicity, so I went with fb because it stands for 'file browser'.

When will it be done?

Here's a to-do list of all features to be implemented by version 1.0:

  • Switching directories
  • Pasting files
  • Deleting files
  • Opening files
  • Address bar
  • Customisable options/config file
  • Pre-built binaries for releases
    • Linux (x86_64)
    • Linux (ARM 64-bit)
    • Windows (x86_64)
    • Windows (ARM 64-bit)
    • MacOS (ARM 64-bit)
    • MacOS (x86_64)
  • External Packages
    • AUR Packages
      • fb
      • fb-bin
      • fb-git
    • Flatpak
    • Winget

Downloading and Installing (Linux)

  1. Go to the latest release and download a Linux build. Binaries should be included.
  2. Rename it to fb and copy it to /bin (you will require root permissions to do so).

Compiling and Installing (Linux)

  1. Make sure clang and git are installed (check with your distro for support);
  2. Clone this repo: git clone https://codeberg.org/WinFan3672/fb;
  3. cd into it;
  4. Run pip install -r requirements.txt;
  5. Run pip install nuitka to install Nuitka (the compiler);
  6. Run make to compile;
  7. Run make install to install your compiled executable.

Downloading and Installing (Windows)

  1. Go to the latest release and download a Windows build;
  2. Rename the downloaded file to fb.exe.

Currently, there is no way to install fb, so you'll need to run fb.exe to use it.

Compiling (Windows)

  1. Make sure you have both Visual Studio and Git for Windows installed;
  2. Clone the repo: git clone https://codeberg.org/WinFan3672/fb;
  3. cd into it and run pip install -r requirements.txt and pip install nuitka;
  4. Run the Compile-Windows.bat script to compile fb;
  5. Run the Install-Windows.bat script as administrator to install your newly compiled fb.

Using

To run the installed fb from a terminal:

$ fb

Contributing

There are several ways you can contribute:

  • Report issues. I would love to know if you have any bug reports or suggestions.
  • Contribute code. Pull requests are welcome. In fact, I encourage it. If you're new to contributing to projects, definitely give it a try.
  • Write documentation. If you enjoy doing that, go for it.
  • Provide builds for alternate environments (other Linux architectures, Windows, etc.)
  • Spread the word. If you like it, tell all your nerdy friends about it. Maybe they'll like it as well.