muzzle-velocity/README.md
randogoth d6f8f14752 fix screenshot links to use full Codeberg URLs
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-19 19:35:58 +03:00

71 lines
3.1 KiB
Markdown
Executable file

# Muzzle Velocity
<img src="assets/blaster.svg" width="96" alt="Muzzle Velocity logo">
A fast and minimalist but opinionated note-taking app inspired by the legendary *Notational Velocity* on MacOS and *Terminal Velocity* for command line terminals.
Built for speed and efficiency, eliminating unnecessary UI clutter. Every action should be as fast and frictionless as possible.
## Screenshots
<table>
<tr>
<td align="center"><a href="https://codeberg.org/randogoth/muzzle-velocity/src/branch/main/screenshots/01.jpg" target="_blank"><img src="screenshots/01.jpg" width="180"></a><br><sub>Search with tags</sub></td>
<td align="center"><a href="https://codeberg.org/randogoth/muzzle-velocity/src/branch/main/screenshots/02.jpg" target="_blank"><img src="screenshots/02.jpg" width="180"></a><br><sub>View mode</sub></td>
<td align="center"><a href="https://codeberg.org/randogoth/muzzle-velocity/src/branch/main/screenshots/03.jpg" target="_blank"><img src="screenshots/03.jpg" width="180"></a><br><sub>Editor menu</sub></td>
<td align="center"><a href="https://codeberg.org/randogoth/muzzle-velocity/src/branch/main/screenshots/04.jpg" target="_blank"><img src="screenshots/04.jpg" width="180"></a><br><sub>Preview mode</sub></td>
<td align="center"><a href="https://codeberg.org/randogoth/muzzle-velocity/src/branch/main/screenshots/05.jpg" target="_blank"><img src="screenshots/05.jpg" width="180"></a><br><sub>Edit mode</sub></td>
</tr>
</table>
## Features
**Search & Create** — Type to filter notes by title. Hit Enter on a new title to create it instantly. Search by `#tags`, `+projects`, `@contexts`, or `/folders`. Mix them freely.
**Gestures**
- Swipe right to mark a note as a favorite (swipe right again to remove)
- Swipe left to move a note to the trash
**Editor** — Three modes: View (syntax-highlighted, read-only), Edit, and Preview (rendered Markdown with LaTeX). Autosave, manual save, font size slider, and plain-text sharing from the editor menu.
**Tags** — Detected automatically from note content. `#tags`, `+projects`, and `@contexts` are all searchable.
**File Organization** — Notes live in a directory you choose. Subfolders are supported and ordered by most recently modified. Empty folders are cleaned up automatically.
**Commands** — Type in the search bar and press Enter:
| Command | Action |
|---|---|
| `:help` | Open help guide |
| `:about` | Open app info |
| `:tags` | Toggle tag visibility |
| `:fav` | Toggle favorites filter |
| `:sub` | Toggle subdirectory search |
| `:content` | Toggle file content search |
| `:day` | Switch to light theme |
| `:night` | Switch to dark theme |
| `:extern` | Toggle external editor |
| `:intern` | Toggle internal editor |
| `:emptytrash` | Permanently delete trashed notes |
## Download
Get the latest .apk on the [Release Page](https://codeberg.org/randogoth/muzzlevelocity/releases)
## Build
```sh
flutter build apk --release
```
On systems without Flutter installed, [devbox](https://www.jetify.com/devbox) provides a reproducible environment:
```sh
devbox install
devbox shell
flutter build apk --release
```
---
Made with 🧡 by randogoth