Need help with my-notes?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

penge
172 Stars 25 Forks MIT License 425 Commits 17 Opened issues

Description

Simple and fast note-taking in Chrome with Google Drive support.

Services available

!
?

Need anything else?

Contributors list

# 149,054
Elixir
Swift
Haskell
React
313 commits
# 26,192
TypeScr...
React N...
custom-...
form-va...
4 commits

My Notes




My NotesChrome extension for simple and fast note-taking



Features

→   Automatically saved and updated in every open tab (How to open)

→   Context menu to save selected text to note or My Notes in second computer (Context menu)

→   Back up notes to Google Drive (Google Drive Sync)

→   Sync notes between My Notes and Google Drive, edit them from other devices or My Notes (Google Drive Sync)

→   Auto Sync notes to Google Drive (Google Drive Sync)

→   Drag and drop image with automatic image upload to Google Drive (Google Drive Sync)

→   Toolbar (Bold, Italic, Underline, etc.)

→   Themes (Light, Dark, Custom)

→   Keyboard shortcuts

→   Command palette (Command palette)

→   Works offline


How to open

My Notes:

  1. Click on My Notes icon in Chrome Toolbar (pin the icon for quick access)
  2. Use keyboard shortcut (see chrome://extensions/shortcuts)

Options:

  1. Click on gear icon in bottom left corner
  2. Right-click on the pinned icon in Chrome Toolbar and select Options
  3. Click on three-dots icon next to My Notes in Chrome Toolbar and select Options
  4. Use keyboard shortcut (see Options)



Context menu

Context menu allows you to quickly save selected text from any website to My Notes, or to transfer selected text to My Notes on other computers.

To use Context menu, select the text on website, right-click and see "My Notes" Context menu.

Context menu has these options:

  • Save to [note name]
    – Option for every note. As you create new notes, they are automatically added to the list. My Notes doesn't have to be open. Google Drive Sync is not required.
  • Save to remotely open My Notes
    – My Notes on other computers needs to be open. The same Google Account needs to be used. Google Drive Sync is not required. The destination note to save the text will be named "@Received" (created automatically if it doesn't exist, otherwise updated).



Custom theme

Custom theme allows you to customize My Notes styles in many ways.

To use a Custom theme, open Options, select "Custom" theme, and click on the "Customize" button to start creating your own theme.

To start, paste into the editor content of light.css or dark.css. Then, modify CSS variables as you like to change background colors, text colors, etc. You can add any valid CSS as well to make further changes. Click on the "Save" button to save the custom theme.



Command palette

Command palette is a window which you can open with

Cmd + P
(or
Ctrl + P
) and use your keyboard to quickly perform any of the following actions:
  1. Find note(s) by their name, and open one. (default behavior)
  2. Find note(s) by their content, and open one. (type ? first, then continue)
  3. Find commands, and execute one. (type > first, then continue)

To navigate between the results, use

Up
and
Down
arrow keys.

To open a selected note or execute a selected command, press

Enter
.

The last executed command can be repeated with

Cmd + Shift + P
(or
Ctrl + Shift + P
).



Google Drive Sync

Google Drive Sync (see Options) saves your notes to your personal Google Drive and synchronizes the changes between your local My Notes and your Google Drive every time you click on the "Sync now" button (bottom left corner).

Why sync:

  • Having a backup of your notes (notes can be restored)
  • Can edit notes from other sources (Google Drive, My Notes, vice versa)
  • Can sync notes and edit them from other computers (by installing My Notes and using the same Google Account)

Location

Notes are uploaded to your Google Drive under the folder "My Notes". This folder is created automatically. If the folder exists from a previous installation, notes are downloaded and uploaded and the synchronization continues.

Synchronization

Synchronization works both ways — to Google Drive, from Google Drive.

Notes are synchronized every time you click on the "Sync now" button. While the synchronization is in progress, "Sync now" button will spin. "Sync now" button has a tooltip that shows the time of the most recent synchronization.

Auto Sync

Auto Sync (see Options) can automatically sync your notes to and from Google Drive every time you open My Notes, and every 6 seconds if your local notes were updated since the last sync.

Image upload

When Google Drive Sync is enabled and having an internet connection, you can Drag and Drop one image at a time into a note. Each image is immediately uploaded to your Google Drive under "My Notes" / "assets" folder, which is created automatically.

Access

My Notes can only access the folder "My Notes" it created, and files it created inside this folder. It cannot see, access nor modify, any other files in your Google Drive.



Tips and tricks

  1. Set a keyboard shortcut to quickly open My Notes (for example
    Cmd + Shift + M
    ), which you can set on this page
    chrome://extensions/shortcuts
    . If you make the keyboard shortcut Global, it will open My Notes even if Google Chrome is closed.
  2. Check keyboard shortcuts (open Options) on how to quickly do some actions.
  3. Hold down the Shift key (
    Cmd + Shift + V
    ) to paste text in a plain format (without styles).
  4. Hide Toolbar and Sidebar if you prefer a simple interface.
  5. See Google Fonts for a font you like, write its name into My Notes Options to use it.
  6. Note name is present in the URL, therefore you can save it to bookmarks for quick access. If you append saved URL with
    &focus
    , it will always open that note in Focus mode.
  7. Use Context menu to transfer selected text to My Notes on other computers.
  8. Use Custom theme to customize the look of My Notes in any way as needed.
  9. Drag and Drop selected text onto a note's name in the Sidebar to insert the text into the note.
  10. Drag and Drop a TXT file anywhere in the bottom part of the Sidebar (the area with 3 icons) to import the file as a new note.
  11. Drag the Sidebar line to resize the Sidebar, double-click on the Sidebar line to restore the original Sidebar width.



How to contribute

  1. Share your feedback (what to improve, what to change) under Issues or join the discussion in Discussions.
  2. Join the development.
  3. Help to test the upcoming version (to get feedback, to improve or tweak).
  4. Help to improve the documentation.
  5. Buy Me a Coffee.



How to develop

Develop:

$ npm install
$ export MY_NOTES_CLIENT_ID=    # needed when developing Google Drive Sync
$ npm run develop-watch                    # see "out" folder

MY_NOTES_CLIENT_ID
can be created at Google Cloud / APIs & Services / Credentials / OAuth 2.0 Client IDs.

Code check:

$ npm run lint

Tests:

$ npm test

Build:

$ npm run build   # see "out" folder



Folder structure

env/              # Helpers for environment variables

out/ # Bundled My Notes (excluded from Git)

src/ background/ google-drive/ # Everything related to Google Drive Sync # - File operations (List, Create, Get, Update, Delete) # - Synchronization (to Google Drive, from Google Drive) # - Queries (find My Notes folder, list files in My Notes folder) # - Multipart bodies (create My Notes folder, create file, update file) # - Tests

init/           # Run when My Notes is installed/updated
                  # - Sets a Unique ID for My Notes installation (used by Context menu), if not already set
                  # - Migrates notes and options
                  # - Creates Context menu and attaches the events
                  # - Creates a Notification when My Notes is installed/updated
                  # - Registers the ways to open My Notes (icon click, keyboard shortcut)
                  # - Registers events to trigger Google Drive Sync from My Notes

dom/ # Helpers to get DOM elements

integration/ # Integration tests for Google Drive Sync

messages/ # Communication between My Notes and background script

notes/ # Everything related to Notes # - Create/Rename/Delete notes; Note editing, Note saving # - Toolbar # - Every UI init and update when data changes # - Registers commands (Toggle Focus mode - can be enabled in Options)

options/ # Everything related to Options # - Font type, Font size, Theme, etc. # - Every UI init and update when data changes

shared/ # Everything common (used at more places) # - Date formatting (Last sync) # - Managing the permissions (Requesting, Removing, Checking) # - Helpers for Chrome Storage # - Default values (Notes, Options)

themes/ # Light, Dark, Custom

background.ts # Main script for background page notes.ts # Main script for notes options.ts # Main script for options

static/ # All static files (images, icons, HTML, CSS) copied to out/

.editorconfig # To enforce same editor configuration .eslintrc # To enforce code quality and same coding style with ESLint .eslintignore # Files excluded from ESLint checking .gitignore # Files excluded from Git

jest.config.js # Jest configuration tsconfig.json # Typescript configuration

package-lock.json package.json

LICENSE # MIT manifest.json # Main extension file

README.md



Browser support

My Notes has full support for Google Chrome only. Although it may be possible to install it in other browsers, the support is not complete.

Support for other Chromium-based browsers will be added if possible.



Security and Privacy

My Notes doesn't collect any personal information or data. All your notes are stored locally in your browser. If you use Google Drive Sync, My Notes can back up the notes to your personal Google Drive.

To provide Google Drive functionality, My Notes has an application in Google Cloud. The sole purpose of this application is to authenticate you securely towards Google Drive and to allow the synchronization of notes.



Permissions

My Notes has the permissions listed in

manifest.json
.

Required:

  • "storage"
    — used to save your notes and options to Chrome Storage (locally in your Chrome)
  • "unlimitedStorage"
    — used to increase the default storage limit (which is 5MB)
  • "contextMenus"
    — used to create My Notes Context menu

Required permissions are shown to the user before installing the extension, and are needed at all times to provide the basic functionality.

Optional:

  • "identity"
    — needed for "Enable Google Drive Sync" (see Options)

Optional permissions are needed only to provide additional functionality that can be enabled via a checkbox in Options.

User has the choice to either approve or deny the permissions.



QA

1. Where is My Notes published? What is the process behind publishing My Notes?

My Notes is published on Web Store, a store for Google Chrome extensions. When publishing a new version, I first make a new release here on GitHub. Then I create a build of the new release and send it to Web Store for a review. The review usually takes between 24 hours and a few days. After a successful review, the new version is available on Web Store.


2. Can I install My Notes manually by downloading it from GitHub?

Yes, My Notes can be installed manually by downloading it from GitHub, but keep in mind, that Google Drive Sync works only if My Notes is installed from Web Store. To install My Notes manually, download the zip file of the latest version which you can find here. Then, unpack the downloaded file and install NPM packages followed by

npm run build
. Finally, open
chrome://extensions
address in Google Chrome and click the "Load unpacked" button to load the unpacked extension from your drive by selecting the
out
directory.


3. Why isn't Google Drive Sync working?

Google Drive Sync works only if My Notes is installed from Web Store on Google Chrome. There are two reasons for this. First, Google Chrome provides an "identity" API that My Notes relies on. Secondly, for security reasons, Google Drive Sync works only if My Notes has an ID equal to "lkeeogfaiembcblonahillacpaabmiop", which is the ID it has on Web Store (also in the URL). When My Notes is installed manually, it gets an ID that is different to the one on Web Store.


4. What browsers and operating systems are supported?

Currently, only Google Chrome is supported. Other Chromium-based browsers are next to come, if possible. Common OS's (Windows, Linux, macOS) are supported. Chromebooks are supported as well.


5. How can I open or edit notes from my phone?

If Google Drive Sync is enabled, My Notes will sync your notes to/from your personal Google Drive into a folder called "My Notes".

To get access to your Google Drive from a phone, install the Google Drive app. To open the note, click on it from the list in the folder. To edit the note, click on the overflow menu (the three-circle icon) next to the note, and select "Open with" from the context menu. You can then choose a preferred editor from the list.


6. What is the size limit for my notes?

Notes are NOT limited in size with the addition of

"unlimitedStorage"
permission.


7. (Google Drive) Where are images uploaded?

Images are uploaded to your personal Google Drive under the folder My Notes / assets. The folder "assets" is created automatically when needed.


8. (Google Drive) Are images stored privately?

Yes, only you can see the images. If you'd like to share the image(s) publicly or with someone specific, use the Share button in Google Drive.


9. (Google Drive) Are images deleted from my Google Drive after I remove them from a note?

No, images continue to be stored in your Google Drive for future use. This way images don't have to be uploaded again. If you'd like to delete an image permanently, delete the image in Google Drive.


10. (Google Drive) How can I reuse a previously uploaded image after I have removed it from a note?

Go to your Google Drive, find the image you'd like to insert, right-click on the image and click on "Get link". Copy the link and paste it into My Notes using the "Insert Image" button.


11. Is My Notes free?

My Notes is open source, free to download, install, and use. The recommended way to install My Notes is from Web Store.




Created with ❤ in 2019.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.