60 lines
2.1 KiB
Markdown
60 lines
2.1 KiB
Markdown
# Aliveline
|
|
|
|
## About
|
|
|
|
Aliveline is a small app made with Rust + Slint to track daily activity on a timeline.
|
|
All activity is saved into TOML logs, which are human readable/editable.
|
|
|
|
App can operate in Record and Review modes.
|
|
|
|
Record mode allows you to update timeline by starting, stopping and chaining events:
|
|
|
|
|
|
By clicking on the timeline in Record mode you can hide controls to make app smaller and place it somewhere in the background:
|
|
|
|
|
|
Review mode may be used to show some activity, tracked on another day:
|
|
|
|
|
|
Aliveline currently supports Linux only, but you can compile it to your platform.
|
|
|
|
## Features
|
|
|
|
### Events
|
|
Events are main timeline building blocks. They have name, start and end.
|
|
Example of event in TOML format shown below:
|
|
```toml
|
|
[[events]]
|
|
name = "test"
|
|
start = 12:05:45
|
|
end = 13:00:11
|
|
finished = true
|
|
```
|
|
_Note: if event is not finished yet, it may have_ `end = start`.
|
|
|
|
## Building
|
|
Requirements:
|
|
- Rust toolchain
|
|
- Slint dependencies (see [Platforms](https://docs.slint.dev/latest/docs/slint/guide/platforms/desktop/) and [Backends & Renderers](https://docs.slint.dev/latest/docs/slint/guide/backends-and-renderers/backends_and_renderers/))
|
|
|
|
Instructions:
|
|
Run `cargo build --release`
|
|
|
|
## Usage
|
|
|
|
Just run `aliveline` by any preferred way, for example:
|
|
```
|
|
$ ./aliveline
|
|
```
|
|
|
|
## Configuration
|
|
Aliveline tries to find config at:
|
|
- `$XDG_CONFIG_DIR/aliveline/config.toml`
|
|
- `./config.toml` (relative to working directory)
|
|
|
|
If config isn't found, Aliveline uses default values defined in [config.toml](https://2ndbeam.ru/git/2ndbeam/aliveline/src/branch/master/config.toml).
|
|
Keep in mind that default paths are relative, and in this case logs will be written to and read from current working directory.
|
|
|
|
## Contribution
|
|
~~You can contribute to Aliveline by creating issue on this repository, then we'll discuss it.~~
|
|
I guess, it is not an option right now, since account creation is disabled on my Forgejo instance, but you may contact me via email: 2ndbeam@disroot.org
|