Skip to content

Commit 0a8f9e0

Browse files
update README to reflect app name lookup
1 parent 45daee7 commit 0a8f9e0

1 file changed

Lines changed: 15 additions & 15 deletions

File tree

README.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ For example, you can use this in almost any Markdown editor with syntax highligh
2727
```md
2828
## My favorite stock macOS apps
2929

30-
TextEdit: <openany://app/com.apple.textedit>
30+
TextEdit: <openany://app/TextEdit>
3131
```
3232

3333
That's a very silly example. Why would you want to launch TextEdit in such a complicated way?
@@ -40,7 +40,7 @@ How about embedding a shortcut to edit a file with [TableFlip](https://tableflip
4040

4141
```md
4242
Preview: <openany://app/com.brettterpstra.marked2/view?path=~/document.md>
43-
Edit Tables: <openany://app/de.christiantietze.TableFlip/view?path=~/document.md>
43+
Edit Tables: <openany://app/TableFlip/view?path=~/document.md>
4444

4545
... document goes here ...
4646
```
@@ -49,12 +49,14 @@ Open any app, or any file, or any file in any app!
4949

5050
## Usage
5151

52-
Powered by the `openany://` URL scheme, you can launch apps and open files!
52+
Powered by the `openany://` URL scheme, you can launch apps and open files.
5353

5454
Open app:
5555

5656
- `openany://app/com.apple.textedit`<br>
57-
launches TextEdit via its bundle identifier.
57+
launches TextEdit via its bundle identifier. It's a bit cumbersome, so:
58+
- `openany://app/TextEdit`<br>
59+
launches TextEdit via its app name (not case-sensitive, actuall). That may not always be unique, though. Pick your poison 🙂
5860

5961
Open file:
6062

@@ -65,13 +67,13 @@ Open file:
6567

6668
Open files with app:
6769

68-
- `openany://app/com.apple.textedit/view?path=/path/to/file.txt`<br>
70+
- `openany://app/TextEdit/view?path=/path/to/file.txt`<br>
6971
opens `/path/to/file.txt` in TextEdit.
70-
- `openany://app/com.apple.textedit/view?url=file:///path/to/file.txt`<br>
72+
- `openany://app/TextEdit/view?url=file:///path/to/file.txt`<br>
7173
opens `/path/to/file.txt` in TextEdit, but using a `file://` URL instead of a path.
72-
- `openany://file/openwith/com.apple.textedit?path=/path/to/file.txt`<br>
74+
- `openany://file/openwith/TextEdit?path=/path/to/file.txt`<br>
7375
opens `/path/to/file.txt` in TextEdit.
74-
- `openany://file/openwith/com.apple.textedit?url=file:///path/to/file.txt`<br>
76+
- `openany://file/openwith/TextEdit?url=file:///path/to/file.txt`<br>
7577
opens `/path/to/file.txt` in TextEdit, but using a `file://` URL instead of a path.
7678

7779
Reveal file:
@@ -81,7 +83,7 @@ Reveal file:
8183
- `openany://file/reveal?url=file:///path/to/file.txt`<br>
8284
reveals `/path/to/file.txt` in Finder, but using a `file://` URL instead of a path.
8385

84-
## How to get an app's bundle ID
86+
## Bonus: How to get an app's bundle ID
8587

8688
You can drag and drop any app onto the OpenAny application icon to extract its bundle ID.
8789

@@ -91,8 +93,6 @@ You can drag and drop any app onto the OpenAny application icon to extract its b
9193
<img src="screenshots/openany_bundle-id.png" alt="Screenshot of the Bundle ID extractor" width="300">
9294
4. then close it (and quit the app).
9395

94-
> ⚠️ For apps, you need the bundle identifier. PR's welcome for lookup of application by name!
95-
9696
## Why `file://`?!
9797

9898
### Easy parsing reason
@@ -139,14 +139,14 @@ The query parameters are called the URL's _payload._
139139
### List of possible `VERB`s
140140

141141
- For the `app` host
142-
- with `BUNDLE_ID` being the `SUBJECT`:
142+
- with `APP_ID` (a bundle identifier or app name) being the `SUBJECT`:
143143
- (none): Launches the app. Alias ans shorthand to `launch`.
144-
- `launch`: `/app/BUNDLE_ID/launch`
145-
- `view`: `/app/BUNDLE_ID/view` opens a file, specified by the payload, in the app. Alias for `/file/openwith/BUNDLE_ID`.
144+
- `launch`: `/app/APP_ID/launch`
145+
- `view`: `/app/APP_ID/view` opens a file, specified by the payload, in the app. Alias for `/file/openwith/APP_ID`.
146146
- For the `file` host:
147147
- `reveal`: Reveal a file, specified by the payload, in Finder.
148148
- `open`: Open a file, specified by the payload, in the default app.
149-
- `openwith`: Open a file, specified by the payload, with the app being the `OBJECT`. Alias for `/app/BUNDLE_ID/view`. Example: `openany://file/openwith/com.apple.textedit?path=/path/to/file.txt` opens `/path/to/file.txt` in TextEdit.
149+
- `openwith`: Open a file, specified by the payload, with the app being the `OBJECT`. Alias for `/app/APP_ID/view`. Example: `openany://file/openwith/com.apple.textedit?path=/path/to/file.txt` opens `/path/to/file.txt` in TextEdit.
150150
- `show`: Alias for `reveal`.
151151

152152
### List of possible Payloads

0 commit comments

Comments
 (0)