# miro
A native pdf viewer for Windows and Linux (Wayland/X11) with configurable keybindings.
## Features
- Dark mode (both for the interface and the pdf)
- Vim-like keybindings (by default)
- Configuration file for key bindings (in case you don't like Vim bindings)
- Mouse controls
- Multiple pdfs in tabs
- Cli arg for opening pdfs from the terminal
- Automatic hot-reloading of any viewed pdf (especially useful when writing anything that compiles into pdfs like Latex/Typst/etc.)
- Text copying in documents
- Internal links (such as a table of contents)
- External links (email, webisites, etc. copies on click)
- Bookmarks
- Optional RPC server to control the viewer from another program
## Configuration
The configuration file is located at `~/.config/miro-pdf/miro.conf` (or `.config/miro-pdf/miro.conf` in the home directory of your operating system). An example configuration file is located at `/assets/default.conf` which contains all the default bindings for the program.
### Configuration File Format
The configuration file uses a simple text format with three types of commands:
#### Comments and Empty Lines
```
# This is a comment
# Comments start with # and are ignored during parsing
# Empty lines are also ignored
```
#### Key Bindings
```
Bind <key_sequence> <action>
```
Key sequences can be:
- Single keys: `j`, `k`, `h`, `l`
- Modified keys: `Ctrl+r`, `Shift+Tab`
- Key chords (multiple keys): `"Z Z"` (quotes required for sequences with spaces)
All available actions are bound in the example config file.
#### Mouse Bindings
```
MouseBind <mouse_input> <action>
```
Mouse inputs can be:
- Basic buttons: `MouseLeft`, `MouseRight`, `MouseMiddle`, `MouseBack`, `MouseForward`
- With modifiers: `Ctrl+MouseLeft`, `Shift+MouseRight`
All available actions are bound in the example config file.
#### Settings
```
Set <setting> <value>
```
Available settings:
- `Rpc <True|False>` - Enable/disable RPC server
- `RpcPort <number>` - Set RPC server port
#### Error Handling
The configuration parser provides detailed error messages with line numbers when parsing fails. Errors on one line don't prevent parsing of other lines
Example error output:
```
Configuration parsing errors:
Line 3: Unknown command: InvalidCommand
Line 5: Unknown action: InvalidAction
Line 7: Invalid port number: 'not_a_number'. Must be a valid integer
```
## Installation
### Pre-compiled binary
Head over to [releases](https://github.com/vincent-uden/miro/releases) and download the latest binary for your platform, then place it somewhere in your path.
### Crates.io
This is pretty much the same as the following option, but doesn't require cloning the repo. See [building from source](#building-from-source) for possible complications when compiling for Windows. I've had **no** problems compiling on Linux thus far.
```sh
cargo install miro-pdf
```
### Building from source
On linux, the commands below would clone the repository, compile the project and copy the resulting binary to `/usr/bin/`.
```sh
git clone https://github.com/vincent-uden/miro.git
cd miro
cargo r --release
cp ./target/release/miro /usr/bin/miro
```
#### Windows
On Windows, the same rough process *should* work, but often doesn't. I highly recommend downloading a precompiled binary for Windows. The problem lies in compiling the crate `mupdf-sys` which requires [MSVC](https://visualstudio.microsoft.com/vs/features/cplusplus/).
The Visual Studio project embedded in this crate requires Visual Studio 2019 which isn't available for downloading anymore, but can [optionally be compiled using Visual Studio 2022](https://github.com/messense/mupdf-rs/pull/125). Even with this option, the build might just not work sometimes due to issues with the Windows 10/11 SDK kits which I have not managed to solve.
However, I've managed to get compilation working in github actions which is what produces the release binaries which do function correctly on Windows systems.
#### Windows
Building on linx require some hidden dependendencies that you probably already have. On arch they are:
- `clang`
- `unzip`