Skip to content

Commit 2c05aff

Browse files
committed
Add license. Update README.md
1 parent c606bba commit 2c05aff

File tree

12 files changed

+201
-13
lines changed

12 files changed

+201
-13
lines changed

README.md

Lines changed: 33 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,14 @@
22

33
Rust Bookmark (d)Menu is a dmenu/ncurses based interface to manage bookmarks independently of your web browser. It also supports file/folder bookmarks
44

5+
Find a TUI version of RBMenu [here](https://github.com/DevHyperCoder/rbmenu-tui)
6+
57
## Features
68
- Insert Bookmark
79
- List Bookmark(s) \[With coloured output]
810
- Remove Bookmark
11+
- Edit Bookmarks
12+
- Copy to clipboard (Available on [rbmenu-tui](https://github.com/DevHyperCoder/rbmenu-tui))
913

1014
## FAQ
1115
**Location of Bookmark file ?**
@@ -15,7 +19,7 @@ The Bookmark file for `rbmenu` is stored in `~/.local/share/rbmenu/`
1519
The Bookmark file is stored in `json` format.
1620

1721
**More features ?**
18-
Yes, more features are on the way. Some planned ones are, copy to clipboard, modify bookmarks and so on.
22+
Yes, more features are on the way. Some planned ones are, groups for bookmarks
1923

2024
## Installation
2125
`rbmenu` is available on [crates.io](https://crates.io/crates/rbmenu)
@@ -34,30 +38,47 @@ Yes, more features are on the way. Some planned ones are, copy to clipboard, mod
3438
| Option / Flags | Description |
3539
| ---------------- | -------------------------- |
3640
| `-h` `--help` | Prints help information |
37-
| `-i` | Insert a new bookmark |
38-
| `-l` | List all bookmarks |
41+
| `-V` | Prints version information |
3942
| `-n` `--name` | Name of the bookmark |
40-
| `-V` `--version` | Prints version information |
43+
| `-i` `--id` | Id of the bookmark |
44+
| `-u` `--url` | Url of the bookmark |
45+
46+
## CLI - Subcommands
47+
48+
| Subcommands | |
49+
| `list` | List all bookmarks |
50+
| `insert` | Add new bookmark |
51+
| `update` | Update bookmarks |
52+
| `remove` | List all bookmarks |
4153

4254
## Examples
55+
> Scripts working with `dmenu` or `rofi` would be published soon.
4356
**Insert a new bookmark**
4457

45-
`rbmenu` reads from `stdin`, therefore, you are able to pipe text into it.
46-
`-n` is the name of the bookmark. (Not required as if not provided, the domain name is used)
58+
- `-n` is the name of the bookmark. (Not required as if not provided, the domain name is used)
59+
- `-u` is the link of the bookmark.
4760

48-
`echo "https://discord.com/app" | rbmenu -in "Discord"`
49-
> Scripts working with `dmenu` or `rofi` would be published soon.
61+
`rbmenu insert -u "https://domain.com" -n "Name"`
5062

5163
**List bookmarks**
5264

53-
Without the name option, `rbmenu -l` displays all the available bookmarks. Give a regex string to the `-n` flag to filter out the bookmarks
65+
Without the name option, `rbmenu list` displays all the available bookmarks. Give a regex string to the `-n` flag to filter out the bookmarks
66+
67+
- `-n` is the name of the bookmark.
68+
- `-i` is the id of the bookmark.
5469

55-
`rbmenu -ln "git*"`
70+
`rbmenu list -n "git*"`
5671

5772
**Remove Bookmark**
5873

59-
Use the `-r` option with a valid unsigned integer (+ve only) to delete the bookmark with the specific id.
60-
`rbmenu -r 1`
74+
- `-n` is the name of the bookmark.
75+
- `-i` is the id of the bookmark.
76+
77+
**Update Bookmark**
78+
79+
- `-n` is the name of the bookmark.
80+
- `-u` is the link of the bookmark.
81+
- `-i` is the id of the bookmark. REQUIRED
6182

6283
## License
6384

res/scripts/rbmenu_clip

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
#!/bin/sh
22

3+
# DOES NOT WORK.
4+
# Functionality available in rbmenu-tui
5+
36
# i -> insert
47
# l -> list
58

res/scripts/rbmenu_dmenu

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
#!/bin/sh
22

3+
# DOES NOT WORK.
4+
# WIP
5+
36
# rbmenu_dmenu - wrapper around rbmenu to interface with dmenu
47
# runs `rbmenu -l`
58

src/bookmark.rs

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,21 @@
1+
/*
2+
* RBMenu - Rust Bookmark Manager
3+
* Copyright (C) 2021-2022 DevHyperCoder
4+
*
5+
* This program is free software: you can redistribute it and/or modify
6+
* it under the terms of the GNU General Public License as published by
7+
* the Free Software Foundation, either version 3 of the License, or
8+
* (at your option) any later version.
9+
*
10+
* This program is distributed in the hope that it will be useful,
11+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
12+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13+
* GNU General Public License for more details.
14+
*
15+
* You should have received a copy of the GNU General Public License
16+
* along with this program. If not, see <https://www.gnu.org/licenses/>.
17+
*/
18+
119
use crate::parser::{get_domain_name, is_url};
220
use chrono::prelude::Local;
321
use colored::*;

src/bookmark_query.rs

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,21 @@
1+
/*
2+
* RBMenu - Rust Bookmark Manager
3+
* Copyright (C) 2021-2022 DevHyperCoder
4+
*
5+
* This program is free software: you can redistribute it and/or modify
6+
* it under the terms of the GNU General Public License as published by
7+
* the Free Software Foundation, either version 3 of the License, or
8+
* (at your option) any later version.
9+
*
10+
* This program is distributed in the hope that it will be useful,
11+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
12+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13+
* GNU General Public License for more details.
14+
*
15+
* You should have received a copy of the GNU General Public License
16+
* along with this program. If not, see <https://www.gnu.org/licenses/>.
17+
*/
18+
119
use serde::{Deserialize, Serialize};
220
use structopt::StructOpt;
321

src/commands.rs

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,21 @@
1+
/*
2+
* RBMenu - Rust Bookmark Manager
3+
* Copyright (C) 2021-2022 DevHyperCoder
4+
*
5+
* This program is free software: you can redistribute it and/or modify
6+
* it under the terms of the GNU General Public License as published by
7+
* the Free Software Foundation, either version 3 of the License, or
8+
* (at your option) any later version.
9+
*
10+
* This program is distributed in the hope that it will be useful,
11+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
12+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13+
* GNU General Public License for more details.
14+
*
15+
* You should have received a copy of the GNU General Public License
16+
* along with this program. If not, see <https://www.gnu.org/licenses/>.
17+
*/
18+
119
use crate::{
220
bookmark::Bookmark,
321
bookmark_query::{BookmarkQuery, BookmarkUpdateQuery},

src/config.rs

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,21 @@
1+
/*
2+
* RBMenu - Rust Bookmark Manager
3+
* Copyright (C) 2021-2022 DevHyperCoder
4+
*
5+
* This program is free software: you can redistribute it and/or modify
6+
* it under the terms of the GNU General Public License as published by
7+
* the Free Software Foundation, either version 3 of the License, or
8+
* (at your option) any later version.
9+
*
10+
* This program is distributed in the hope that it will be useful,
11+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
12+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13+
* GNU General Public License for more details.
14+
*
15+
* You should have received a copy of the GNU General Public License
16+
* along with this program. If not, see <https://www.gnu.org/licenses/>.
17+
*/
18+
119
use structopt::StructOpt;
220

321
use crate::bookmark_query::{BookmarkQuery, BookmarkUpdateQuery};

src/data.rs

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,21 @@
1+
/*
2+
* RBMenu - Rust Bookmark Manager
3+
* Copyright (C) 2021-2022 DevHyperCoder
4+
*
5+
* This program is free software: you can redistribute it and/or modify
6+
* it under the terms of the GNU General Public License as published by
7+
* the Free Software Foundation, either version 3 of the License, or
8+
* (at your option) any later version.
9+
*
10+
* This program is distributed in the hope that it will be useful,
11+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
12+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13+
* GNU General Public License for more details.
14+
*
15+
* You should have received a copy of the GNU General Public License
16+
* along with this program. If not, see <https://www.gnu.org/licenses/>.
17+
*/
18+
119
use home::home_dir;
220
use regex::Regex;
321
use serde::{Deserialize, Serialize};

src/error.rs

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,21 @@
1+
/*
2+
* RBMenu - Rust Bookmark Manager
3+
* Copyright (C) 2021-2022 DevHyperCoder
4+
*
5+
* This program is free software: you can redistribute it and/or modify
6+
* it under the terms of the GNU General Public License as published by
7+
* the Free Software Foundation, either version 3 of the License, or
8+
* (at your option) any later version.
9+
*
10+
* This program is distributed in the hope that it will be useful,
11+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
12+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13+
* GNU General Public License for more details.
14+
*
15+
* You should have received a copy of the GNU General Public License
16+
* along with this program. If not, see <https://www.gnu.org/licenses/>.
17+
*/
18+
119
pub type Result<T> = std::result::Result<T, Error>;
220

321
#[derive(Debug)]

src/lib.rs

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,21 @@
1+
/*
2+
* RBMenu - Rust Bookmark Manager
3+
* Copyright (C) 2021-2022 DevHyperCoder
4+
*
5+
* This program is free software: you can redistribute it and/or modify
6+
* it under the terms of the GNU General Public License as published by
7+
* the Free Software Foundation, either version 3 of the License, or
8+
* (at your option) any later version.
9+
*
10+
* This program is distributed in the hope that it will be useful,
11+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
12+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13+
* GNU General Public License for more details.
14+
*
15+
* You should have received a copy of the GNU General Public License
16+
* along with this program. If not, see <https://www.gnu.org/licenses/>.
17+
*/
18+
119
pub mod bookmark;
220
pub mod bookmark_query;
321
pub mod commands;

0 commit comments

Comments
 (0)