Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pjkaufman/obsidian-mobile-suggester-helper

An Obsidian plugin that helps out with selecting different items in a selector list on mobile since there are no arrow keys on mobile.
https://github.com/pjkaufman/obsidian-mobile-suggester-helper

Last synced: about 1 month ago
JSON representation

An Obsidian plugin that helps out with selecting different items in a selector list on mobile since there are no arrow keys on mobile.

Awesome Lists containing this project

README

        

# Mobile Suggester Helper

This plugin is designed to help get a similar experience for selecting files from the wiki link suggester.

There are 3 commands that are added by the plugin that help with making sure you can navigate through the selection list and select the desired file name.

## Why is this useful?

It may not for your use case. I have a setting enabled where all my links should be markdown links. This means that on mobile when I select the file from the dropdown, the typical behavior is to convert that link straight to a markdown link. This works pretty good if you do not plan on referencing a subset of the document.

In my case, I have multiple files with the same name, but they are in different folders. I often link to a subset of these documents via their headings. Well, if I want to do this like on the desktop, it is not possible when you need to reference a file that is not the first file in the list because selecting it concerts the link straight to a markdown link. So to get around this, I needed to add a couple of commands to allow me to modify which entry in the suggester is suggested (up and down options) and then select an option from the dropdown.

## How to use

First [install the plugin manually](#manually-installing-the-plugin). Once that is done, I find it easiest to go ahead and add the new commands to the mobile toolbar. Once that is done, I use the up and down arrows in the mobile toolbar to help me. Then once it is on the file that I want to select, I use the checkmark inside the circle to select it. Once a file is selected, I can proceed with typing `#` or `^` and then use the suggester from there to select what I need to.

## Commands

| Name | Action |
| ---- | ------ |
| `mobile-suggester-helper-move-selector-down` | Move the selected item down one in the suggester. |
| `mobile-suggester-helper-move-selector-up` | Move the selected item up one in the suggester. |
| `mobile-suggester-helper-select-heading` | Select the highlighted item in the suggester. |

## Contributing

- Clone this repo.
- Make sure your NodeJS is at least v16 (`node --version`).
- `npm i` to install dependencies.
- `npm run dev` to start compilation in watch mode.
- Before committing make sure to run `npm run lint`

## Manually installing the plugin

- Copy over `main.js` and `manifest.json` to your vault `VaultFolder/.obsidian/plugins/obsidian-mobile-suggester-helper/`.