markdown · 1278 bytes Raw Blame History

FORTRESS

A command-line file explorer written in modern Fortran with fzf integration.

Installation

From AUR (Arch Linux)

yay -S fortress
# or
paru -S fortress

Shell integration is automatically set up for bash and fish. Zsh users need to add to ~/.zshrc:

source /usr/share/fortress/fortress.sh

From Source

Prerequisites

  • gfortran 10+ or ifort
  • fpm (Fortran Package Manager)

Install fpm

# Using cargo (if you have Rust)
cargo install fpm

# Or download from GitHub releases
# https://github.com/fortran-lang/fpm/releases

Build & Run

# Build the project
fpm build

# Run FORTRESS
fpm run

# Or build and run in one command
fpm run --flag "-O2"

Shell Integration (Optional)

To enable the "cd on exit" feature (press 'c' to navigate your shell to a directory):

# Add to your .bashrc or .zshrc:
source /path/to/fortress/fortress.sh

# Then use:
fortress  # instead of 'fpm run'

This allows you to navigate to directories and have your shell follow when you press 'c'.

Controls

  • ↑/↓: Navigate up/down
  • : Enter directory
  • : Go back to parent directory
  • c: CD to selected directory and exit (requires shell integration)
  • q: Quit

License

MIT

View source
1 # FORTRESS
2
3 A command-line file explorer written in modern Fortran with fzf integration.
4
5 ## Installation
6
7 ### From AUR (Arch Linux)
8
9 ```bash
10 yay -S fortress
11 # or
12 paru -S fortress
13 ```
14
15 Shell integration is automatically set up for bash and fish. Zsh users need to add to `~/.zshrc`:
16 ```bash
17 source /usr/share/fortress/fortress.sh
18 ```
19
20 ### From Source
21
22 #### Prerequisites
23
24 - gfortran 10+ or ifort
25 - fpm (Fortran Package Manager)
26
27 ### Install fpm
28
29 ```bash
30 # Using cargo (if you have Rust)
31 cargo install fpm
32
33 # Or download from GitHub releases
34 # https://github.com/fortran-lang/fpm/releases
35 ```
36
37 ### Build & Run
38
39 ```bash
40 # Build the project
41 fpm build
42
43 # Run FORTRESS
44 fpm run
45
46 # Or build and run in one command
47 fpm run --flag "-O2"
48 ```
49
50 ### Shell Integration (Optional)
51
52 To enable the "cd on exit" feature (press 'c' to navigate your shell to a directory):
53
54 ```bash
55 # Add to your .bashrc or .zshrc:
56 source /path/to/fortress/fortress.sh
57
58 # Then use:
59 fortress # instead of 'fpm run'
60 ```
61
62 This allows you to navigate to directories and have your shell follow when you press 'c'.
63
64 ## Controls
65
66 - `↑/↓`: Navigate up/down
67 - `→`: Enter directory
68 - `←`: Go back to parent directory
69 - `c`: CD to selected directory and exit (requires shell integration)
70 - `q`: Quit
71
72 ## License
73
74 MIT