summaryrefslogtreecommitdiff
path: root/README.md
blob: ec92b4488783d17824f17a5baf2dd2bfe077c857 (plain)
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
# Simple Bookmarks Manager

Simple but customizable solution for storing your Browser bookmarks.

<div align="center">
  <img src="https://files.catbox.moe/0jllib.jpg" alt="Screenshot cosmic" />
</div>

## Installation

### Cargo

```sh
cargo install --git https://github.com/ndpm13/sbm-rs
```

### Compose file

```yml
services:
  sbm-rs:
    container_name: sbm-rs
    image: ghcr.io/ndpm13/sbm-rs:0.1.0
    volumes:
      - ./config:/root/.config/sbm-rs
    ports:
      - "8080:8080"
```

## Usage

Configuration files for sbm-rs are stored by default in
`$XDG_CONFIG_HOME/sbm-rs/`, on first use it'll create `config.toml`,
`style.css`, `bookmarks.json`. Update `bookmarks.json` manually with your
bookmarks. I am working on a better way to manage them, but for now you'll need
a text editor.

When editing `config.toml` **make sure to use absolute paths**, relative paths
aren't supported for now.

### Override Browser NTP

For Firefox based browsers there are many ways to achieve this, the easiest is
using [this extension](https://addons.mozilla.org/en-US/firefox/addon/new-tab-override/).

<div align="center">
  <img
    src="https://files.catbox.moe/3ap80w.jpg"
    alt="new-tab-override screenshot"
  />
</div>

Chromium used to have a flag for this (`--custom-ntp`). However, as I'm writing
this I can't find it in Brave anymore, nor in stock Chromium. So if you're not
using an old version of Chromium by chance, you'll have to use an extension like
[this](https://chromewebstore.google.com/detail/icpgjfneehieebagbmdbhnlpiopdcmna?utm_source=item-share-cb).

## Themes

<div align="center">
  <img
    src="https://files.catbox.moe/2ub78b.jpg"
    alt="Screenshot simple themes"
  />
</div>

By default the active theme will be `simple-gruvbox`. But you can easily use one
of the other themes in `examples/`. For example, here is how to use the `cosmic`
theme:

- First download the theme to sbm-rs home directory

  ```sh
  wget "https://github.com/ndpm13/sbm-rs/raw/refs/heads/main/examples/cosmic.css" -O ~/.config/sbm-rs/cosmic.css
  ```

- Then update `~/.config/sbm-rs/config.toml`

  ```toml
  # Remember to use the absulote path!
  style_file = "/home/<USER>/.config/sbm-rs/cosmic.css"
  ```

## To-Do List

- [ ] CLI for managing bookmarks
- [*] Container image
- [ ] Browser extension

## License

sbm-rs is released under the MIT License. For more details, see the LICENSE
file.