ObsidianCustomFrames/README.md

40 lines
3.1 KiB
Markdown
Raw Normal View History

2022-03-22 12:03:48 +01:00
# Obsidian Custom Frames
An Obsidian plugin that turns web apps into panes using iframes with custom styling. Also comes with presets for Google Keep and more.
2022-03-20 00:20:09 +01:00
2022-03-26 11:23:11 +01:00
⚠️⚠️⚠️ **For header-heavy sites like Google Keep to work, this plugin requires Obsidian 0.14.3.** ⚠️⚠️⚠️
2022-03-22 17:07:02 +01:00
![A screenshot of the plugin in action](https://raw.githubusercontent.com/Ellpeck/ObsidianCustomFrames/master/screenshot.png)
2022-03-22 13:27:52 +01:00
2022-03-22 17:07:02 +01:00
![A screenshot of the plugin's settings](https://raw.githubusercontent.com/Ellpeck/ObsidianCustomFrames/master/settings.png)
2022-03-22 00:55:20 +01:00
2022-03-22 14:01:49 +01:00
## Usage
To use this plugin, simply go into its settings and add a new frame, either from a preset shipped with the plugin, or a custom one that you can edit yourself. Each frame's pane can be opened using the "Custom Frames: Open" command.
### On Obsidian Mobile
Unfortunately, Obsidian Mobile does not run on [Electron](https://www.electronjs.org/), which is what allows iframes and [webviews](https://www.electronjs.org/docs/latest/api/webview-tag) to be displayed with very few restrictions related to cookies, cross-origin resource sharing, and so on. This means that a lot of sites won't work there, especially ones that you have to log in to. However, when you create a frame, you can toggle the "Disable on Mobile" option to hide a Desktop-only frame in Obsidian mobile.
2022-03-22 14:01:49 +01:00
## Presets
By default, Custom Frames comes with a few presets that allow you to get new panes for popular sites up and running quickly.
- [Obsidian Forum](https://forum.obsidian.md/)
2022-03-26 16:11:30 +01:00
- [Google Keep](https://keep.google.com), optimized for a narrow pane on the side
- [Google Calendar](https://calendar.google.com/calendar/u/0/r/day), optimized by removing some buttons. Close side panel with top-left button.
- [Todoist](https://todoist.com), optimized for a narrow (half-height) side panel by removing some buttons and slimming margins.
- [Notion](https://www.notion.so/) (it's recommended to close Notion's sidebar if used as a side pane)
2022-03-29 14:07:25 +02:00
- [Twitter](https://twitter.com)
2022-03-22 14:01:49 +01:00
2022-03-29 13:21:17 +02:00
If you create a frame that you think other people would like, don't hesitate to create a pull request with [a new preset](https://github.com/Ellpeck/ObsidianCustomFrames/blob/master/src/settings.ts#L5).
2022-03-22 14:01:49 +01:00
## Roadmap
- ~~Allow setting a custom icon for each pane~~
2022-03-22 14:09:08 +01:00
- Allow displaying custom frames in Markdown code blocks
2022-03-27 15:35:08 +02:00
- Allow creating links that open in a custom frame rather than the browser
2022-03-22 14:06:42 +01:00
- Possibly allow executing custom JavaScript in iframes (though security implications still need to be explored)
2022-03-29 21:57:18 +02:00
- Add a global setting that causes popups to be opened in a new Obsidian window rather than the default browser
2022-03-22 14:06:42 +01:00
## Acknowledgements
Thanks to [lishid](https://github.com/lishid) for their help with making iframes work in Obsidian for a purpose like this. Also thanks to them for *motivating* me to turn Obsidian Keep into a more versatile plugin, which is how Custom Frames was born.
2022-03-22 17:02:39 +01:00
If you like this plugin and want to support its development, you can do so through my website by clicking this fancy image!
[![Support me (if you want), via Patreon, Ko-fi or GitHub Sponsors](https://ellpeck.de/res/generalsupport.png)](https://ellpeck.de/support)