A performant and extensive terminal-based project editor with a wide variety of modern shortcuts.
omega [path]This section will guide you through the initial steps of opening the editor. When specifying a path, if it points to a file, the editor will set the surrounding directory as the project directory. If the path points directly to a directory, that directory will become the project directory.
Within the editor, you'll find a panel on the left side that displays your project's directory structure, allowing for easy navigation through your project files.
Navigating through your project is straightforward: selecting an entry from the left panel will close the currently open file and open the newly selected one. The editor efficiently manages your files by checking if a file is already open and retrieving its data from its current state or loading it from the filesystem to store in the state. All changes to files are temporarily cached in the state, ensuring that unsaved files can be reopened, edited further, and eventually saved, provided the editor remains open. Upon exiting the editor (using Ctrl + p -> typing >q and enter), it will prompt you to save any unsaved changes.
Files that are being edited will be marked with an asterisk * in the title bar; saving these files will remove the asterisk.
The editor provides a Quick Access view, accessible with the global shortcut Ctrl + p. This view displays your currently open files and, by entering command mode with >, allows you to perform file and directory management tasks. These tasks include opening a new project, saving the current file, adding, editing, and deleting files, and more, such as opening the info and debugger views. Please exercise caution when deleting files, as this action is irreversible and there is no intermediate trash bin for recovery.
Because you'll be opening many views, there is a global shortcut Esc to close the current one.
Moving the cursor/selector via mouse input, arrow keys and
Tabis also possible.
| Global | Keybinding |
|---|---|
| Open Quick Access | Ctrl + p |
| Close current View | Esc |
| Quick Access | Command Name |
|---|---|
| Open Debugger | debug |
| Open Infos | info |
| Opening a File/Project | open |
| Saving the current opened File | save |
| Creating a new File/Directory | new |
| Renaming a File/Directory | rename |
| Deleting a File/Directory | delete |
| Quitting | quit |
| Editor | Keybinding |
|---|---|
| Copying Line | Ctrl + c |
| Paste Clipboard | Ctrl + v |
| Cut Line | Ctrl + x |
| Move Line | Shift + ↑/↓ |
| Move Cursor to EoL | Shift + ←/→ |
| Ident | Tab |
| Remove Ident | Shift + Tab |
To install omega, you can use Cargo by running the following command in your terminal:
cargo install omegaAlternatively, you can download the binary directly from the releases page.
For Linux-based systems, it is necessary to have the libx11-dev (Debian/Ubuntu) or libX11-devel (Fedora/RHEL) packages installed.
It's important to note that on macOS, omega relies on ncurses as its backend, which will need to be installed if not already pre-installed. For Linux-based systems and Windows, omega uses crossterm as its backend.
There are currently some smaller known issues:
- Performance Issues on scrolling and editing files.
- If the content only needs a scrollbar on the x-Axis, this scrollbar won't be interactable.
Tabsare currently not rendered/shown. So some files usingTabscould look not like their should.- Fix macos coloring -> wait for
cursive-backendto update
If you're encountering more Bugs please create an Issue and if you want to fix one create a Pull Request containing the fix.
I warmly welcome and thoroughly review all contributions submitted through Pull Requests.