Skip to content

Commit 085e2e8

Browse files
committed
Updated README.md
1 parent 82f2aa3 commit 085e2e8

File tree

4 files changed

+48
-13
lines changed

4 files changed

+48
-13
lines changed

README.md

Lines changed: 42 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,17 @@ The tool aims to let you search and navigate through DEVONthink effectively. It
66
Just enter the keyword and it will do a live and prefix search then nicely present the results for you.
77
![Search Result](screenshots/search-result.png)
88

9+
## Create shortcuts for DEVONthink items!
10+
It is a pitty that we cannot create direct entries for DEVONthink items in LaunchBar. We have to first open this action then search then select one... What if we can create a shortcut for the item and make it accessible directly from LaunchBar without using this tool.
11+
12+
Well, you can! Just press `⌘ + ⌥ + ↵` on that item.
13+
14+
![Make shortcut](screenshots/make-shortcut.png)
15+
16+
Next time that item will be searchable directly from LaunchBar by its name.
17+
18+
![Appears in LaunchBar result](screenshots/inetloc-shortcut.png)
19+
920
## Requirements
1021
This tool requires Python3 to be installed at the path `/usr/bin/python3`.
1122
If you are using macOS Catalina or higher version, you can run this command in terminal
@@ -21,15 +32,15 @@ If you use homebrew or other ways to install Python3, make sure it is accessible
2132

2233
### Modifier keys
2334
If it is not a group:
24-
- `⌘ + Enter` to reveal that item in DEVONthink
25-
- `⇧ + Enter` to reveal that item in Finder
26-
- `⌥ + Enter` to open that item externally
35+
- `⌘ + ` to reveal that item in DEVONthink
36+
- `⇧ + ` to reveal that item in Finder
37+
- `⌥ + ` to open that item externally
2738

2839
If it is a group:
29-
- `⌘ + Enter` to reveal that item in DEVONthink
30-
- `⌥ + Enter` to navigate through that group in Launchbar
40+
- `⌘ + ` to reveal that item in DEVONthink
41+
- `⌥ + ` to navigate through that group in Launchbar
3142

32-
Note that if you are already in "navigation mode", just press enter and you can navigate that group, press `⌥ + Enter` to open that group in DEVONthink.
43+
Note that if you are already in "navigation mode", just press and you can navigate that group, press `⌥ + ` to open that group in DEVONthink.
3344

3445
### Excluded tag
3546
If you tag a file/group `exclude-from-launchbar`, it will not be shown in the result.
@@ -40,19 +51,38 @@ You can adjust all those values in the config file `config.py`.
4051

4152
![Config](screenshots/config.png)
4253

43-
Defualt values:
54+
`config.py` file:
4455

4556
```python
46-
a = 0.8
47-
b = 0.5
48-
frequency_weight = 2
49-
excluded_tag = 'exclude-from-launchbar'
50-
max_result_num = 80
57+
# Do not change this class
58+
class DefaultConfig:
59+
a = 0.8
60+
b = 0.5
61+
frequency_weight = 2
62+
excluded_tag = 'exclude-from-launchbar'
63+
max_result_num = 80 # Set to None to cancel the limit. Note that this may cause performance issue!
64+
shortcut_path = '~/Documents/Devonthink' # Set to None to disable shortcut creation
65+
66+
67+
# change this one
68+
class UserConfig(DefaultConfig):
69+
a = 0.8
70+
b = 0.5
71+
frequency_weight = 2
72+
excluded_tag = 'exclude-from-launchbar'
73+
max_result_num = 80
74+
shortcut_path = '~/Documents/Devonthink'
75+
76+
5177
```
78+
Do not change the `DefaultConfig` class. Instead change the properties of `UserConfig`.
5279

5380
The `max_result_num` option can be set to `None` so that all the results will be presented in LaunchBar. Note that too many results may cause performance issue!
5481

5582
## More details
83+
### The "shorcuts"
84+
As you may notice, the so-called shortcut is just a `inetloc` file created in your filesystem with the name and item link of the corresponding DEVONthink item. The default creation path is set to be `~/Documents/Devonthink`. You can change it to any other locations that you have write permission to. Set it to `None` will prevent the creation of any "shortcuts".
85+
5686
### Frequency score
5787
Except for the search score given by DEVONthink, the tool will adjust that score based on the frequency you open items.
5888

config.py

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,4 +12,9 @@ class DefaultConfig:
1212

1313
# change this one
1414
class UserConfig(DefaultConfig):
15-
a = 0.8
15+
a = 0.8
16+
b = 0.5
17+
frequency_weight = 2
18+
excluded_tag = 'exclude-from-launchbar'
19+
max_result_num = 80
20+
shortcut_path = '~/Documents/Devonthink'

screenshots/inetloc-shortcut.png

326 KB
Loading

screenshots/make-shortcut.png

115 KB
Loading

0 commit comments

Comments
 (0)