mirror of
https://github.com/notion-enhancer/notion-enhancer.git
synced 2025-11-04 08:08:08 +11:00
263 lines
9.3 KiB
Markdown
263 lines
9.3 KiB
Markdown
# <img src="./mods/core/icons/mac+linux.png" height="20px"></img> notion-enhancer
|
|
|
|
ended up here? this is a work-in-progress version of the enhancer, not ready for public use.
|
|
if you're interested in using the project, switch back to the [master branch](https://github.com/dragonwocky/notion-enhancer).
|
|
|
|
notion.so is a pretty awesome tool already, but there's always room for improvements.
|
|
it might just be a preference, it might be something crucial to your setup,
|
|
it might be something users have been asking for for a long time,
|
|
or it might even be something you haven't realised you need yet
|
|
\- there's something that would make your user experience a lot better.
|
|
|
|
this package is a mod-loader for the desktop app, with custom colour theming and extra feature enhancements.
|
|
|
|
want to contribute? check out the [contribution guidelines](CONTRIBUTING.md) and the [documentation](DOCUMENTATION.md).
|
|
|
|
for support, join the [discord server](https://discord.gg/sFWPXtA).
|
|
|
|
## installation
|
|
|
|
**coming from <= v0.7.0? things are a bit different - have a read of [the update guide](UPDATING.md)**
|
|
**before following these instructions.**
|
|
|
|
1. install node.js: [windows/macOS](https://nodejs.org/en/download/), [linux/WSL](https://github.com/mklement0/n-install).
|
|
_a computer restart may be required here._
|
|
2. install the enhancer globally: run `npm i -g notion-enhancer` in the terminal/command prompt.
|
|
3. make sure no notion processes are running (check the task manager!), and apply the hack:
|
|
run `notion-enhancer apply` in the terminal/command prompt.
|
|
|
|
### command-line interface
|
|
|
|
```
|
|
Usage:
|
|
$ notion-enhancer <command> [options]
|
|
|
|
Commands:
|
|
apply : add enhancements to the notion app
|
|
remove : return notion to its pre-enhanced/pre-modded state
|
|
check : check the current state of the notion app
|
|
|
|
For more info, run any command with the `--help` flag:
|
|
$ notion-enhancer apply --help
|
|
$ notion-enhancer remove --help
|
|
$ notion-enhancer check --help
|
|
|
|
Options:
|
|
-y, --yes : skip prompts (may overwrite data)
|
|
-h, --help : display usage information
|
|
-v, --version : display version number
|
|
```
|
|
|
|
### supported clients
|
|
|
|
- the [official windows/mac releases](https://notion.so/desktop).
|
|
- the arch linux AUR [notion-app](https://aur.archlinux.org/packages/notion-app/) package.
|
|
- the linux [notion-app](https://github.com/jaredallard/notion-app) installer.
|
|
- the debian [notion-deb-builder](https://github.com/davidbailey00/notion-deb-builder/).
|
|
|
|
(it can also be run from the wsl to apply enhancements to the windows app.)
|
|
|
|
**using a not-yet-supported operating system or notion installation?** ask for
|
|
[platform support](https://github.com/dragonwocky/notion-enhancer/issues/new?labels=enhancement&template=platform-support.md).
|
|
|
|
mobile clients are not supported and due to system limitations/restrictions cannot be.
|
|
|
|
a chrome extension may be coming soon for web client support.
|
|
|
|
**is this against notion's terms of service? can i get in trouble for using it?**
|
|
|
|
definitely not! i contacted their support team to check, and the response was awesome:
|
|
|
|
"Thanks for taking the time to share this with us. Userscripts and userstyles are definitely
|
|
cool ideas and would be helpful for many users! ... I'll also share this with the rest of the
|
|
team to take to heart for future improvements."
|
|
|
|
## features
|
|
|
|
once applied, modules can be configured via the graphical menu, which is opened from
|
|
the tray/menubar icon or with `CMD/CTRL+E`.
|
|
|
|
|
|
|
|
currently all modules come pre-installed for technical reasons, security assurance, and ease-of-use.
|
|
these include:
|
|
|
|
### notion-enhancer core
|
|
|
|
**tags:** #core
|
|
|
|
**description:** the cli, modloader, menu, & tray.
|
|
|
|
**author**: [dragonwocky](https://github.com/dragonwocky/)
|
|
|
|
**version**: v0.8.0
|
|
|
|
| option | type | default |
|
|
| ---------------------------- | --------------------------------------------------------------------------------------------- | -------------------------- |
|
|
| hide app on open | toggle | no |
|
|
| auto-maximise windows | toggle | no |
|
|
| close window to the tray | toggle | yes |
|
|
| integrated titlebar | toggle | yes |
|
|
| height of frameless dragarea | number input | `15` |
|
|
| integrated scrollbars | toggle | yes |
|
|
| window display hotkey | [accelerator](https://github.com/electron/electron/blob/master/docs/api/accelerator.md) input | `CommandOrControl+Shift+A` |
|
|
|
|
|
|
|
|
### custom inserts
|
|
|
|
**tags:** #extension
|
|
|
|
**description:** link files for small client-side tweaks.
|
|
|
|
**author**: [dragonwocky](https://github.com/dragonwocky/)
|
|
|
|
**version**: v0.1.1
|
|
|
|
| option | type | default |
|
|
| --------------------- | ---- | ------- |
|
|
| css insert | file | none |
|
|
| client-side js insert | file | none |
|
|
|
|
### bracketed links
|
|
|
|
**tags:** #extension
|
|
|
|
**description:** render links surrounded with \[\[brackets]] instead of underlined.
|
|
|
|
**author**: [arecsu](https://github.com/arecsu/)
|
|
|
|
**version**: v0.1.0
|
|
|
|
### dark+
|
|
|
|
**tags:** #theme #dark
|
|
|
|
**description:** a vivid-colour near-black theme.
|
|
|
|
**author:** [dragonwocky](https://github.com/dragonwocky/)
|
|
|
|
**version:** v0.1.3
|
|
|
|
| option | type | default |
|
|
| -------------- | ----- | ------------------ |
|
|
| primary colour | color | `rgb(177, 24, 24)` |
|
|
|
|
|
|
|
|
### emoji sets
|
|
|
|
**tags:** #extension
|
|
|
|
**description:** pick from a variety of emoji styles to use.
|
|
|
|
**author:** [dragonwocky](https://github.com/dragonwocky/)
|
|
|
|
**version:** v0.1.3
|
|
|
|
|
|
|
|
### focus mode
|
|
|
|
**tags:** #extension
|
|
|
|
**description:** hide the titlebar/menubar if the sidebar is closed (will be shown on hover).
|
|
|
|
**author:** [arecsu](https://github.com/arecsu/)
|
|
|
|
**version:** v0.1.0
|
|
|
|
|
|
|
|
### gameish
|
|
|
|
**tags:** #theme #dark
|
|
|
|
**description:** a purple, "gamer-styled" theme with a blocky-font.
|
|
|
|
**author:** [LVL100ShrekCultist](https://reddit.com/user/LVL100ShrekCultist/)
|
|
|
|
**version:** v0.1.1
|
|
|
|
|
|
|
|
### neutral
|
|
|
|
**tags:** #theme #dark
|
|
|
|
**description:** smoother colours and fonts, designed to be more pleasing to the eye.
|
|
|
|
**author:** [arecsu](https://github.com/arecsu/)
|
|
|
|
**version:** v0.1.0
|
|
|
|
|
|
|
|
### night shift
|
|
|
|
**tags:** #extension #theme
|
|
|
|
**description:** sync dark/light theme with the system (overrides normal theme setting).
|
|
|
|
**author:** [dragonwocky](https://github.com/dragonwocky/)
|
|
|
|
**version:** v0.1.0
|
|
|
|
### pastel dark
|
|
|
|
**tags:** #theme #dark
|
|
|
|
**description:** a true dark theme with a hint of pastel.
|
|
|
|
**author:** [zenith_illinois](https://reddit.com/user/zenith_illinois/)
|
|
|
|
**version:** v0.1.0
|
|
|
|
|
|
|
|
### property layout
|
|
|
|
**tags:** #extension
|
|
|
|
**description:** auto-collapse page properties that usually push down page content.
|
|
|
|
**author:** [alexander-kazakov](https://github.com/alexander-kazakov/)
|
|
|
|
**version:** v0.2.1
|
|
|
|
### right-to-left
|
|
|
|
**tags:** #extension
|
|
|
|
**description:** enables auto rtl/ltr text direction detection.
|
|
|
|
**author:** [obahareth](https://github.com/obahareth/)
|
|
|
|
**version:** v1.3.0
|
|
|
|
|
|
|
|
### weekly view
|
|
|
|
**tags:** #extension
|
|
|
|
**description:** calendar views named "weekly" will show only the 7 days of this week.
|
|
|
|
**author:** [adihd](https://github.com/adihd/)
|
|
|
|
**version:** v0.5.0
|
|
|
|
|
|
|
|
## contributors
|
|
|
|
[@TarasokUA](https://github.com/TarasokUA/) wrote the first versions of this in python, in early 2020.
|
|
a couple months after I ([@dragonwocky](https://github.com/dragonwocky/)) picked the project up, at first extending
|
|
upon the original base and later moving to the javascript module system.
|
|
|
|
since then, various community members have helped out heaps - some listed as
|
|
[contributors](https://github.com/dragonwocky/notion-enhancer/graphs/contributors) here on github,
|
|
but many helping with code, feedback and testing on discord and in emails.
|
|
|
|
individual modules have their original authors attributed.
|