qreader 0.3.0

A clipboard manager and file reader with emoji support and customizable fonts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

# QReader v0.3.0


A cross-platform file reader and clipboard manager built with Rust using the [eframe](https://github.com/emilk/egui/tree/master/crates/eframe)/[egui](https://github.com/emilk/egui) GUI framework.

## Features


- Open text files via **File → Open…** dialog or directly: `qreader file.txt`
- Real-time clipboard monitoring with configurable auto-update intervals
- Customizable fonts: Default, Monospace, Serif, Sans Serif
- Text alignment: Left, Center, Right, Justify (default)
- Adjustable line spacing (0.8×–3.0×)
- Adjustable font sizes for UI and content areas (independently)
- Background and font color customization with live preview
- Text statistics: line count, word count, last update time
- Always-on-top window option
- Settings persistence — configuration survives restarts
- Keyboard shortcuts for quick access

## Requirements


- Rust toolchain 1.70+
- Windows (primary platform; other platforms compile with minor adjustments)

## Build and Run


```bash
# Clone the repository

git clone https://github.com/holgertkey/qreader.git
cd qreader

# Run in development mode

cargo run

# Build debug binary

cargo build

# Build optimized release binary

cargo build --release
```

The release binary is placed in `target/release/qreader.exe`.

## Usage


```bash
# Open as clipboard manager (default mode)

qreader

# Open a text file

qreader file.txt
qreader path/to/notes.md

# Print version

qreader --version

# Print help

qreader --help

# Run in debug mode (keeps terminal open, enables logging)

qreader -d
qreader -d file.txt
```

Supported file formats: `txt`, `log`, `md`, `json`, `toml`, `yaml`, `ini`, `cfg`, `rs`, `py`, `js`, `ts`, `html`, `css`, `xml`, `sh`, `bat`, and more.

### Controls


| Action                    | Method                               |
|---------------------------|--------------------------------------|
| Read clipboard            | Click **Read** button or **Ctrl+V**  |
| Clear clipboard           | Click **Clear** button               |
| Increase/decrease font    | **Ctrl+Scroll**                      |
| Open a file               | **File → Open…** (native dialog)     |
| Save content to file      | **File → Save…** (native dialog)     |
| Open preferences          | **File → Preferences**               |
| Exit                      | **File → Exit** or **Alt+F4**        |

> In file mode the **Read** and **Clear** buttons are inactive — the window is read-only.

### Auto-Update


Enable **Auto-update** in preferences to monitor the clipboard continuously.
The minimum update interval is 200 ms to keep the system responsive.

### Preferences


| Setting           | Description                                           |
|-------------------|-------------------------------------------------------|
| Background color  | Window background color                               |
| Font color        | Text color for content and UI labels                  |
| UI font size      | Size of interface elements (8–24 px)                  |
| Content font size | Size of displayed clipboard text (8–48 px)            |
| Content margin    | Left and right padding around the text (0–50 mm)      |
| Content font      | Font family for clipboard text                        |
| Text alignment    | Left, Center, Right, or Justify (default)             |
| Line spacing      | Line height multiplier for content text (0.8–3.0×)    |
| Always on top     | Keep window above all others (requires restart)       |
| Auto-update       | Periodically check clipboard (200–5000 ms interval)   |

## Configuration


Settings are stored in `qreader_settings.json` next to the executable and loaded automatically on startup. If the file is missing, sensible defaults are used.

## Architecture


| File                   | Description                              |
|------------------------|------------------------------------------|
| `main.rs`              | Entry point, CLI argument parsing        |
| `app.rs`               | Main application state and update loop   |
| `clipboard_manager.rs` | Cross-platform clipboard operations      |
| `file_reader.rs`       | Extensible file reader (trait + registry)|
| `settings.rs`          | Persistent configuration management      |
| `ui.rs`                | GUI rendering functions                  |
| `font_choice.rs`       | Font selection enumeration               |
| `build.rs`             | Version synchronization to docs          |

## Changelog


See [CHANGELOG.md](CHANGELOG.md) for the full version history.