{"id":13582909,"url":"https://github.com/chrisgrieser/shimmering-obsidian","last_synced_at":"2025-05-15T01:05:44.209Z","repository":{"id":37697251,"uuid":"398836278","full_name":"chrisgrieser/shimmering-obsidian","owner":"chrisgrieser","description":"Alfred workflow with dozens of features for controlling your Obsidian vault.","archived":false,"fork":false,"pushed_at":"2025-04-25T11:35:54.000Z","size":116865,"stargazers_count":926,"open_issues_count":0,"forks_count":43,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-05-10T07:03:55.922Z","etag":null,"topics":["alfred","alfred-workflow","obsidian-md"],"latest_commit_sha":null,"homepage":"https://alfred.app/workflows/chrisgrieser/shimmering-obsidian/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chrisgrieser.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":"https://www.paypal.me/ChrisGrieser","ko_fi":"pseudometa"}},"created_at":"2021-08-22T15:41:18.000Z","updated_at":"2025-05-09T22:20:25.000Z","dependencies_parsed_at":"2023-02-17T11:45:56.498Z","dependency_job_id":"51903301-84dd-4273-b920-8f094b84510f","html_url":"https://github.com/chrisgrieser/shimmering-obsidian","commit_stats":{"total_commits":1292,"total_committers":16,"mean_commits":80.75,"dds":"0.018575851393188847","last_synced_commit":"30a49f518b98ec932364526438299a4091ba10b7"},"previous_names":[],"tags_count":290,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisgrieser%2Fshimmering-obsidian","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisgrieser%2Fshimmering-obsidian/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisgrieser%2Fshimmering-obsidian/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisgrieser%2Fshimmering-obsidian/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chrisgrieser","download_url":"https://codeload.github.com/chrisgrieser/shimmering-obsidian/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254254039,"owners_count":22039792,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alfred","alfred-workflow","obsidian-md"],"created_at":"2024-08-01T15:03:07.138Z","updated_at":"2025-05-15T01:05:44.202Z","avatar_url":"https://github.com/chrisgrieser.png","language":"JavaScript","funding_links":["https://www.paypal.me/ChrisGrieser","https://ko-fi.com/pseudometa","https://ko-fi.com/Y8Y86SQ91'"],"categories":["JavaScript","obsidian-md","Building","🔧 Utilities \u0026 Miscellaneous"],"sub_categories":["Workflows"],"readme":"# Shimmering Obsidian 🎩\n![GitHub downloads](https://img.shields.io/github/downloads/chrisgrieser/shimmering-obsidian/total?label=GitHub%20Downloads\u0026style=plastic\u0026logo=github)\n![Alfred gallery downloads](https://img.shields.io/badge/dynamic/yaml?url=https%3A%2F%2Fraw.githubusercontent.com%2Fchrisgrieser%2F.config%2Frefs%2Fheads%2Fmain%2FAlfred.alfredpreferences%2Falfred-workflow-download-count.yaml\u0026query=shimmering-obsidian\u0026style=plastic\u0026logo=alfred\u0026label=Gallery%20Downloads\u0026color=%235C1F87)\n![Latest release](https://img.shields.io/github/v/release/chrisgrieser/shimmering-obsidian?label=Latest%20Release\u0026style=plastic)\n\nAlfred workflow with dozens of features for controlling your\n[Obsidian](https://obsidian.md/) vault.\n\n[⭐ Featured in the Alfred\nGallery.](https://alfred.app/workflows/chrisgrieser/shimmering-obsidian/)\n\n\u003cimg alt=\"Promo Video\" width=70% src=\"https://user-images.githubusercontent.com/73286100/139678407-9ac39baa-5f49-42a0-9622-0fbaf68540b2.gif\"\u003e\n\n## Table of contents\n\n\u003c!-- toc --\u003e\n\n- [Installation](#installation)\n- [Alfred-based quick switcher](#alfred-based-quick-switcher)\n\t* [How the search works](#how-the-search-works)\n\t* [Main search](#main-search)\n\t\t+ [Search for notes](#search-for-notes)\n\t\t+ [Smart queries](#smart-queries)\n\t\t+ [Search for aliases](#search-for-aliases)\n\t\t+ [Search for folders](#search-for-folders)\n\t\t+ [Search for headings](#search-for-headings)\n\t\t+ [Browse links of a note](#browse-links-of-a-note)\n\t* [Search notes by their tags](#search-notes-by-their-tags)\n\t* [Search bookmarked files](#search-bookmarked-files)\n\t* [Search recent files](#search-recent-files)\n\t* [Search for attachments](#search-for-attachments)\n\t* [Search all external links in the entire vault](#search-all-external-links-in-the-entire-vault)\n\t* [Extra features](#extra-features)\n\t\t+ [Vault search as Alfred fallback](#vault-search-as-alfred-fallback)\n\t\t+ [Previewing notes via QuickLook](#previewing-notes-via-quicklook)\n- [Note-related features](#note-related-features)\n\t* [Create a new note](#create-a-new-note)\n\t* [Scratchpad](#scratchpad)\n- [Screenshot features](#screenshot-features)\n\t* [OCR screenshots](#ocr-screenshots)\n\t* [Image screenshot](#image-screenshot)\n- [Utility features](#utility-features)\n\t* [Workspace switcher](#workspace-switcher)\n\t* [Vault switcher](#vault-switcher)\n\t* [Back up your vault](#back-up-your-vault)\n\t* [CSS files](#css-files)\n\t* [Open various folders](#open-various-folders)\n\t* [Update plugins \u0026 metadata](#update-plugins--metadata)\n- [Plugins, themes, and settings](#plugins-themes-and-settings)\n\t* [Plugins](#plugins)\n\t* [Themes](#themes)\n\t* [Settings \u0026 local plugins](#settings--local-plugins)\n- [Documentation searches](#documentation-searches)\n\t* [Official documentation](#official-documentation)\n\t* [Plugin developer documentation](#plugin-developer-documentation)\n- [Cheatsheet](#cheatsheet)\n- [Credits](#credits)\n- [About the developer](#about-the-developer)\n\n\u003c!-- tocstop --\u003e\n\n## Installation\n*This workflow requires Alfred 5 with\n[Powerpack](https://www.alfredapp.com/powerpack/).*\n\n1. Install the Obsidian plugins [Advanced\n   URI](https://obsidian.md/plugins?id=obsidian-advanced-uri) \u0026 [Metadata\n   Extractor](https://obsidian.md/plugins?id=metadata-extractor).\n2. Enable both plugins.\n3. Download the [latest release at\n   GitHub](https://github.com/chrisgrieser/shimmering-obsidian/releases/latest).\n   Double-click the `.alfredworkflow` file to install it.\n4. Set your vault path in the workflow configuration.\n\n**In the Obsidian plugin settings for the \"Metadata Extractor\"**\n- Enable `Write JSON files automatically when Obsidian launches`.\n- Set `Configure frequency for writing the three JSON files` to how often you\n  want the Metadata to be updated. A value like 30 minutes is reasonable. Do\n  **not** change any of the other settings.\n- Restart Obsidian.\n\n## Alfred-based quick switcher\nThe Alfred-based Quick Switcher is basically an enhanced version of [Obsidian's\nQuick Switcher Core Plugin](https://help.obsidian.md/Plugins/Quick+switcher).\n\n\u003cimg alt=\"promo video\" width=70%\nsrc=\"https://user-images.githubusercontent.com/73286100/139678407-9ac39baa-5f49-42a0-9622-0fbaf68540b2.gif\"\u003e\n\n### How the search works\nAll the search features listed here do not *directly* search your vault, but\nrather use the metadata created by the [Metadata Extractor\nPlugin](https://obsidian.md/plugins?id=metadata-extractor) on a regular basis.\nBy default, this happens every 30 minutes, meaning recently created notes,\nrecently renamed notes, or recent tag changes are not picked up at once. You can\nchange the metadata refresh rate via the Metadata Extractor Plugin's settings.\n\n### Main search\n**`o`: Open files in your vault.**\nThis keyword searches all your notes, aliases, folders, and headings combined.\n\n#### Search for notes\nThis works similar to Obsidian's built-in *Quick Switcher*, but can be triggered\nwithout Obsidian running (in which case it opens Obsidian with the selected\nnote).\n- `⏎`: Open the selected file in Obsidian.\n- `⌘ + ⏎`: Open the file in a new tab. (Can be configured in the workflow\n  settings to open in a new window or split instead.)\n- `⌥ + ⏎`: Reveal the file in Finder.\n- `fn + ⏎`: Append content to the selected note. (Prompt for text or clipboard content)\n- `⌃ + ⏎`: Copy the\n  [Obsidian-URI](https://help.obsidian.md/Advanced+topics/Using+obsidian+URI#Action+`hook-get-address`)\n  to the selected file.\n- `⇧ + ⏎`: Browse a list of all links of the selected note (outgoing links,\n  backlinks, external links.) See at the [section \"Browse Links\"\n  below](#browse-links-of-a-note) for further information.\n- Press `⇧` or `⌘ y` to preview the selected note via macOS' Quick Look feature.\n  Press it again to close the preview. This feature requires [QLMarkdown or\n  Peek](#previewing-notes-via-quicklook) to be installed.\n- 💡 The `o`-search respects the `Excluded files` setting from Obsidian and\n  ignore files and folders added there. (Regex-filters do not work though.)\n\n\u003e [!TIP]\n\u003e There are various settings for appending and opening notes, which can be found\n\u003e in the workflow configuration.\n\n#### Smart queries\n- Add `filename` or `title` to your search query, to display only files and no\n  aliases, folders, or headings. For example, `o obsidian filename` displays\n  only notes that have the `obsidian` in their filename.\n- Add `canvas` to your search to only display canvases (Obsidian 1.1).\n- Similarly, you can also filter for starred or recent files by adding `starred`\n  or `recent` to your query.\n- You can add `#tag` to your search query to search only for files with a\n  specific tag, for example, `o foobar #moc` only displays notes with the name\n  `foobar` that are also tagged with `#moc`.\n\n#### Search for aliases\nThis command also looks for **aliases**, when they are [defined in the\nYAML-Header](https://help.obsidian.md/How+to/Add+aliases+to+note#Set+aliases).\n- Add `alias` to your search query, to only display aliases, for example, `o\n  obsidian alias` only displays notes that have the *alias* `obsidian`.\n\n#### Search for folders\nWhen **selecting a folder**, you can \"browse\" the selected folder—this means\nthat you are now searching only for files and folders inside that folder.\n- When browsing a folder, you also have the option to create a new note *in that\n  folder*. Uses the template note defined in the workflow configuration.\n- Furthermore, you can go up and browse the *parent* folder of the current\n  folder. Basically, you can fully explore the folder structure of your vault\n  via Alfred.\n- Add `folder` to your search query, to only display folders, for example, `o\n  foobar folder` only displays *folders* that have `foobar` in their name.\n- When you are browsing inside a folder, use the query `..` to go up to the\n  parent folder or `new` to create a new\n  note in that folder, respectively.\n\n#### Search for headings\nDisplayed alongside the other search results are all headings in your vault.\nSelecting a heading with `⏎` opens the file *at the respective heading*.\n- `⌃ + ⏎`: Copies either a Markdown link [that uses the Obsidian\n  URI](https://help.obsidian.md/Advanced+topics/Using+obsidian+URI#Action+%60hook-get-address%60)\n  or the wikilink to the selected file, depending on the setting. Also work with\n  headings.\n- Add `heading` to your search query, to only display headings, for example, `o\n  foobar heading` only displays *headings* that include `foobar`.\n- Add `h1`, `h2`, … to your search query, to only display headings of a certain\n  level, for example, `o obsidian h2` only displays *level 2 headings* that\n  include `obsidian`.\n- You can ignore certain (or all) heading levels with the respective workflow\n  configuration.\n\n\u003e [!TIP]\n\u003e If the search results become too crowded, you can ignore certain heading levels\n\u003e in the workflow configuration.\n\n#### Browse links of a note\n**Use `⇧ + ⏎` on any search result of the main `o` search to browse the links of\nthat note**\n\n- Displays a list of *all* links of the note: outgoing links, backlinks, and\n  external links. (As of now, unresolved internal links are not displayed\n  though.)\n- Selecting an outgoing link or backlink opens the respective note.\n\t* All the modifiers (`⌘/⌃/⌥/fn/⇧ + ⏎`) apply the same way as with the main\n\t  `o` search.\n\t* *Yes, this means you can repeatedly use `⇧ + ⏎` to basically traverse\n\t  your graph via Alfred. 😎*\n- for external links:\n\t* Selecting an external link with `⏎` opens the link in the default browser.\n\t* Press `⌥ + ⏎` on an external link to copy the URL to the clipboard\n\t  instead.\n\n### Search notes by their tags\n**`ot`: Search `t`ags and subsequently files with that tag**\n- Display and search a full list of all tags in your vault.\n\t* Select a tag with `⏎` to display \u0026 search all notes with that tag.\n\t* In the following list of your notes, all the modifiers (`⌘/⌃/⌥/fn/⇧ + ⏎`)\n\t  apply the same way as they do with the `o` search.\n\t* Press `⌘ + ⏎` instead to open Obsidian's search pane and search for the\n\t  tag there.\n- Use the workflow configuration to set whether nested tags should be merged\n  with their parent or not.\n\n### Search bookmarked files\n**`ob`: Search `b`ookmarked Files and Searches**\n- When you select a starred *file*, all the modifiers (`⌘/⌃/⌥/fn/⇧ + ⏎`) apply\n  the same way as with the main `o` search.\n- If you select a starred *search*, Obsidian opens the search pane with the\n  respective query.\n- This feature requires the [Bookmark core\n  plugin](https://help.obsidian.md/Plugins/Bookmarks) being enabled.\n\n### Search recent files\n**`or`: Open `r`ecent Files**\n- All the modifiers (`⌘/⌃/⌥/fn/⇧ + ⏎`) apply the same way as with the main `o`\n  search.\n- Only the 10 most recent files are displayed.\n\n### Search for attachments\n**`oa`: `a`ttachments**\n- Searches only for attachments (non-Markdown files) in your vault. `⏎` opens\n  the selected files in your default app. (Obsidian itself is not opened.)\n- The modifiers `⌘/⌃/⌥ + ⏎` and the previewing (`⇧` or `⌘y`) work the same way\n  as with the main `o` search.\n- `⇧ + ⏎`, however, works differently: it opens the file in Obsidian, if\n[Obsidian is able to open\nthem](https://help.obsidian.md/Advanced+topics/Accepted+file+formats). (If not,\nthe file simply is opened in your default app.)\n\n### Search all external links in the entire vault\n**`oe`: Search all `e`xternal links in your entire vault**\n- `⏎`: Opens the link in the browser.\n- `cmd + ⏎`: Reveal the link in Obsidian.\n- `alt + ⏎`: Copies the URL to the clipboard.\n\n### Extra features\n\n#### Vault search as Alfred fallback\nThe main search (`o`) can also be used as [Fallback Search for\nAlfred](https://www.alfredapp.com/help/features/default-results/fallback-searches/),\nbasically a search that shows up when any Alfred search has no result.\n\n#### Previewing notes via QuickLook\nTo avoid accidentally triggering the Quick Look feature, it is suggested you\nturn off activating QuickLook via shift and use `⌘ + Y` instead. You can do so\nin the Alfred Settings under `Features → Previews`:\n\n[QLmarkdown](https://github.com/sbarex/QLMarkdown) and\n[Peek](https://apps.apple.com/app/peek-quick-look-extension/id1554235898) both\nenable previewing of Markdown documents. Peek works with a wide range of other\nfile types than Markdown, but costs around €5. `QLMarkdown` is free, but only\nworks for Markdown and requires some minor setup.\n\n\u003cdetails\u003e\n- The app `QLMarkdown.app` must be started at least once. You may need to\n  right-click the app and select `open`, to be able to allow macOS to trust the\n  app.\n- To enable proper display of YAML headers, you need to enable the respective\n  setting in the Advanced Options of QLMarkdown:\n\n\u003cimg width=\"654\" alt=\"screenshot of QLMarkdown\" src=\"https://user-images.githubusercontent.com/73286100/144729141-72d8cd41-8e45-43e0-a11a-ce98ba97c2ac.png\"\u003e\n\u003c/details\u003e\n\n## Note-related features\n\n### Create a new note\n\u003c!-- LTeX: enabled=false --\u003e\n**`on`: Create a `n`ew note.**\n\u003c!-- LTeX: enabled=true --\u003e\n- **File name:** Anything you type after the keyword `on` (for example, `on\n  foobar`) becomes the file name of the new note (for example, `foobar.md`).\n  (Note that the [Filename Heading Sync\n  Plugin](https://obsidian.md/plugins?id=obsidian-filename-heading-sync) may\n  interfere with this.)\n\t* When triggered via `cmd + ⏎`, the new note is created in a new tab.\n- **Content:** You can select a template note to use in the workflow\n  configuration. Only `{{title}}` is supported as placeholder and is replaced\n  with the file name. Be aware that the template might be overridden by Folder\n  Templates from the [Templater\n  plugin](https://obsidian.md/plugins?id=templater-obsidian).\n- **Location:** The new note is placed in the folder specified in the workflow\n  configuration. If the configuration is empty, it is placed in your vault root.\n- 💡 There are various settings for creating new notes in the workflow\n  configuration.\n\n### Scratchpad\n**`oo` or `triggered via hotkey`: Append to your Scratchpad Note**\nQuickly add text to the note set in the workflow configuration. (This command is\nbasically a quicker version of the `fn + ⏎` mode of the [Alfred-based Quick\nSwitcher](Alfred-based%20Quick%20Switcher.md#search-for-notes).)\n- When using `oo foobar`, appends `foobar` to the note.\n- Using just `oo`, you can also directly open the Scratchpad.\n- Triggered via **hotkey**, appends the current selection.\n- When you add `#foobar` to path of the scratchpad file in the workflow\n  configuration (for example, `Inbox/Scratchpad-Note#Thoughts`), the text is\n  appended to the section with the heading \"foobar.\"\n\n\u003e [!TIP]\n\u003e There are various settings for the scratchpad in the workflow configuration.\n\u003e You can, for instance, use [Alfred's Dynamic\n\u003e Placeholders](https://www.alfredapp.com/help/workflows/advanced/placeholders/)\n\u003e to prefix the current date and time, or use a dynamic path to a daily note.\n\n## Screenshot features\n\u003cimg src=\"https://i.imgur.com/xwdl1N5.gif\" alt=\"OCR Screenshot\" width=50%\u003e\n\n### OCR screenshots\n**`Triggered via Hotkey`: Take an OCR Screenshot.**\n- Similar to the default Mac Hotkey `⌘ ⇧ + 4`, you are able to select part\n  of your screen for a screenshot. However, instead of saving a screenshot, a\n  new note is created which contains the OCR'ed content of the selection.\n- For best results, you should set the languages to be recognized in the\n  workflow settings, such as `eng+deu` for English and German. You can find out\n  the\n  code for your languages in [this\n  list](https://tesseract-ocr.github.io/tessdoc/Data-Files-in-different-versions.html).\n- 💡 There are various settings in the workflow configurations for\n  OCR-screenshots.\n\n**Requirement**  \nFor the OCR-Screenshot Feature, you need to install\n[Tesseract](https://tesseract-ocr.github.io/tessdoc/Installation.html). If you\nuse Homebrew, you can do so with the following command:\n\n```bash\nbrew install tesseract tesseract-lang\n```\n\n\u003e [!TIP]\n\u003e The first time you use the OCR or image screenshot feature, you might need to\n\u003e give Alfred permission to record your screen. You can do so under the macOS\n\u003e system settings.\n\u003e\n\u003e \u003cimg\n\u003e src=\"https://user-images.githubusercontent.com/73286100/131231644-a800c0b0-8dc2-4ae9-bd41-c3937741b94a.png\"\n\u003e alt=\"Permissions for OCR Screenshots\" width=35%\u003e\n\n### Image screenshot\n**`Triggered via Hotkey`: Take an image screenshot.**\n- Similar to the default Mac Hotkey `⌘ ⇧ + 4`, you are able to select part\n  of your screen for a screenshot. The image is directly saved in your\n  vault with the file name `Screenshot {date} {time}.png` and the image is\n  embedded (`![[image_file_name.png]]`) in the note `Images.md` in your vault\n  root.\n- The images are saved in `{vault-path}/screenshots/` by default. You can\n  use the workflow configuration to specify a folder in your vault where to save\n  the images instead.\n- If the file `Images.md` already exists in your vault root, any subsequent\n  screenshots are instead appended to this note. This is intended for taking\n  screenshots in quick succession, for instance during a live lecture or\n  presentation.\n- 💡 There are various settings in the workflow configurations for screenshots.\n\n## Utility features\n\n### Workspace switcher\n**`ow`: Switch to a different `w`orkspace**\n- Displays a list of your workspaces. Select one to open the workspace.\n- You can also manage your Workspaces from here, that is, saving, loading \u0026\n  deleting a workspace.\n- Unsurprisingly, this workflow requires the [Workspaces Core\n  Plugin](https://help.obsidian.md/Plugins/Workspaces) to be enabled.\n\n\u003cimg alt=\"workspace\" width=60%\nsrc=\"https://user-images.githubusercontent.com/73286100/133615940-a56731e5-6b60-4d28-b877-7ea48d10225e.gif\"\u003e\n\n### Vault switcher\n**`ov`: Open `V`aults in Obsidian, Finder, or the Terminal**\n- Select a Vault and press `⏎` to open it in Obsidian.\n- `⌃ ⏎` opens the root of the selected vault in your default Terminal. You can\n  [change the default terminal in the Alfred\n  Settings](https://www.alfredapp.com/help/features/terminal/).\n- `⌥ ⏎` opens the root in Finder.\n- `⇧ ⏎` Control this vault with Alfred.\n\n\u003e [!NOTE]\n\u003e The `Metadata Extractor` and the `Advanced URI` plugin need to be installed\n\u003e and enabled in every vault you want to control. The `Metadata Extractor` needs\n\u003e to be configured in every vault as well.\n\n### Back up your vault\n**`obackup`: Create a `backup` of your vault.**\n- Your whole vault is compressed into a *zip* file and then moved to the\n  location you specified in the workflow configuration.\n- This command respects the maximum number of backups you have set (workflow\n  configuration `max_number_of_bkps`) to prevent taking up too much disk space.\n  When the number is reached, every new backup causes the oldest backup to be\n  deleted.\n- The hidden folders `.obsidian` and `.trash` are included in the backup, the\n  `.git` folder is excluded.\n- 💡 Advanced users: you can use the following AppleScript snippet to trigger a\n  backup. This is useful to create automated backups via\n  [launchd](https://launchd.info/), [Cron\n  jobs](https://ostechnix.com/a-beginners-guide-to-cron-jobs/), or [Keyboard\n  Maestro](https://www.keyboardmaestro.com/main/).\n\n```applescript\ntell application id \"com.runningwithcrayons.Alfred\"\n\trun trigger \"backup-obsidian\" in workflow\n\t\"de.chris-grieser.shimmering-obsidian\"\nend tell\n# pass 'no sound' as argument to turn off backup confirmation sound\n```\n\n\u003e [!WARNING]\n\u003e Please be aware that this is a simplistic backup solution. While I do not\n\u003e have any problems with it, this workflow comes without any warranties, as\n\u003e stated in the\n\u003e [license](https://github.com/chrisgrieser/shimmering-obsidian/blob/main/LICENSE).\n\u003e If you care about safety, please use a professional backup solution.\n\n### CSS files\n**`ocss`: Access your `css` files.**\n- Open a CSS snippet in your default text editor.\n\n### Open various folders\n- `o.obsidian`: The hidden `.obsidian` folder located in your vault root is\n  opened in Finder.\n- `o.trash`: Open the hidden [`.trash`\n  folder](https://help.obsidian.md/Advanced+topics/Deleting+files) located in\n  your vault root is opened in Finder. (Note that you have to select `Move to\n  Obsidian trash` in the Obsidian settings under the `Files \u0026 Links` tab before\n  deleted files can be found here.)\n- `oapplicationsupport`: Open Obsidian's Application Support folder.\n- `oplugins`: The plugin folder in `.obsidian` is opened in Finder.\n- `othemes`: The theme folder in `.obsidian` is opened in Finder.\n\n### Update plugins \u0026 metadata\n**`oupdate`: Update plugins and metadata used by this workflow**\n- Update your community plugins (and beta plugins installed via [the BRAT\n  Plugin](https://github.com/TfTHacker/obsidian42-brat)).\n- Refresh the metadata used for this workflow manually.\n\n## Plugins, themes, and settings\n\n### Plugins\n**`op`: combined Search of community `p`lugins and community themes.**\n- Press `⏎` to open the plugin's GitHub repository.\n\t* Use `⌘ + ⏎` to open the plugin in Obsidian's Community Plugin Browser\n\t  instead.\n\t* Press `⌥ + ⏎` to copy the plugin URI (`obsidian://show-plugin?id=…`) to\n\t  your clipboard.\n\t* `⌘⌥ + ⏎`: Copy the plugin link together with a description.\n- Only plugins officially included in the community plugins are displayed —\n  plugins solely available via GitHub or still in review are not shown.\n- Add `plugin` to the search query to only display plugin, for example, use `op\n  focus plugin` as search query to only display *plugins* with the term `focus`.\n- The `op` search also considers the name of the plugin's author, meaning the\n  query `op JaneDoe` returns all plugins (and themes) authored by the user\n  `JaneDoe`.\n\n### Themes\n**`op`: Combined Search of community `p`lugins and community themes.**\n- Press `⏎` to open the theme's GitHub repository in the browser.\n\t* Use `⌘ + ⏎` to open the theme browser instead. (There are no separate\n\t  theme pages in Obsidian Theme Browser that can be opened.)\n\t* Press `⌥ + ⏎` to copy the theme URI (`obsidian://show-theme?id=…`) to your\n\t  clipboard.\n\t* `⌘⌥ + ⏎`: Copy the plugin link together with a description.\n\t* Use `⇧` or `⌘ + Y` to open a Quick Look Preview of the theme's promo\n\t  screenshot. Press `⇧` or `⌘ + Y` again to close the preview.\n- Only themes officially included in the community themes are displayed — themes\n  solely available via GitHub or still in review are not shown.\n- Add `theme` to the search query to only display themes, for instance use `op\n  focus theme` as search query to only display *themes* with the term `focus`.\n- The `op` search also considers the name of the theme's author, meaning the\n  query `op JaneDoe` returns all themes (and plugins) authored by the user\n  `JaneDoe`.\n\n\u003cimg alt=\"plugin search\" width=60%\nsrc=\"https://user-images.githubusercontent.com/73286100/131027623-5e8b3667-d00d-47dc-ba49-6938686e2aca.gif\"\u003e\n\n### Settings \u0026 local plugins\n**`o,`: Search and directly open specific setting tabs.**\n- The search includes Obsidian main settings, quick access to the plugin and\n  theme browser, as well as settings for plugins. Press `⏎` to open the\n  respective setting *directly*.\n- `⌥ + ⏎` opens the local plugin folder in `.obsidian/plugins/` in Finder.\n- `⇧ + ⏎` enables/disables the plugin.\n- *⚙️ For developers:*\n\t* `⌘ + ⏎` opens the local plugin folder in your default Terminal.\n\t  (You can [change the default terminal in the Alfred\n\t  Settings](https://www.alfredapp.com/help/features/terminal/).)\n\t* `⌃ + ⏎` copies the plugin's ID. (Hold `⌃` to see the plugin's id.)\n\t* `fn + ⏎` runs `git pull` in the plugin's directory.\n\n\u003e [!TIP]\n\u003e `o,` refers to the `⌘ ,` shortcut used to open the settings.\n\n## Documentation searches\n\n### Official documentation\n**`oh`: Search the official [Obsidian help\n(documentation)](https://help.obsidian.md/Start+here)**\n- This command mimics the search behavior on the official documentation site,\n  meaning that it also searches for headings inside individual documentation\n  pages.\n\t* Press `⏎` to open in your default browser.\n\t* Use `⌥ + ⏎` to copy the link to your clipboard.\n\n### Plugin developer documentation\n\u003c!-- LTeX: enabled=false --\u003e\n**`odd`: `o`bsidian `d`eveloper `d`ocumentation Search**\n\u003c!-- LTeX: enabled=true --\u003e\nSearch the official [Obsidian developer docs](https://docs.obsidian.md/Home).\n\n## Cheatsheet\n- `o`: All notes\n- `oe`: All external links\n- `ot`: Tags\n- `ob`: Bookmarked files/searches\n- `or`: Recent files\n- `oa`: Attachments\n- `oo`: Append/open to scratchpad\n- `on`: New note\n- `ow`: Workspace switcher\n- `ov`: Vault switcher\n- `oh`: Documentation search\n- `op`: Search plugins/themes\n- `o,:` Search settings and installed plugins\n- `ocss`: Open CSS snippets\n\n## Credits\n- Thanks to [@kometenstaub](https://github.com/kometenstaub) for\n  developing the [metadata extractor\n  plugin](https://github.com/kometenstaub/metadata-extractor), as this workflow\n  is its main client.\n- Also thanks to [@Vinzent03](https://github.com/Vinzent03) for his invaluable\n  [Advanced URI plugin](https://github.com/Vinzent03/obsidian-advanced-uri),\n  which enables Alfred to control various aspects of Obsidian.\n- Most icons created by [Freepik (Flaticon)](https://www.flaticon.com/authors/freepik).\n\n## About the developer\nIn my day job, I am a sociologist studying the social mechanisms underlying the\ndigital economy. For my PhD project, I investigate the governance of the app\neconomy and how software ecosystems manage the tension between innovation and\ncompatibility. If you are interested in this subject, feel free to get in touch.\n\n- [Website](https://chris-grieser.de/)\n- [ResearchGate](https://www.researchgate.net/profile/Christopher-Grieser)\n- [Mastodon](https://pkm.social/@pseudometa)\n- [LinkedIn](https://www.linkedin.com/in/christopher-grieser-ba693b17a/)\n\n\u003e [!IMPORTANT]\n\u003e For questions, bug reports, or feature requests for this workflow,\n\u003e please open a [GitHub\n\u003e issue](https://github.com/chrisgrieser/shimmering-obsidian/issues).\n\n\u003ca href='https://ko-fi.com/Y8Y86SQ91' target='_blank'\u003e\u003cimg height='36'\nstyle='border:0px;height:36px;' src='https://cdn.ko-fi.com/cdn/kofi1.png?v=3'\nborder='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchrisgrieser%2Fshimmering-obsidian","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchrisgrieser%2Fshimmering-obsidian","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchrisgrieser%2Fshimmering-obsidian/lists"}