Bits and Bobs

by Leroy
5
4
3
2
1
Score: 50/100

Description

Drawing boards with Apple Pencil, slides, Excel spreadsheets and maths tools for Obsidian.

Reviews

No reviews yet.

Stats

0
stars
61
downloads
0
forks
5
days
2
days
2
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
21
commits

Latest Version

2 days ago

Changelog

Share anything as a link. Right-click a note, drawing board, slide deck, spreadsheet, PDF or picture and choose Share as a link (or use the share button on boards, decks and spreadsheets). Pick whether the link keeps up with your changes or is a copy. Links open in any web browser, phones too, and are view only, except spreadsheets, which you can also let people edit. Manage your links under Shared links in the Share menu or in settings.

Sign-in is now called Keyring, and sync and share links now use obsidian.leroyw1e.workers.dev, which also lists all my plugins.

README file from

Github

Bits and Bobs

Drawing boards, slides, Excel spreadsheets and maths tools for Obsidian, built to work well with Apple Pencil on iPad as well as on desktop.

Features

Drawing boards (.mboard)

  • An endless board you can pan and zoom, with pen, highlighter, eraser, shapes, arrows and text.
  • Stylus support: pressure-sensitive lines, palm rejection (once the pen touches the board, fingers pan instead of drawing), and pinch to zoom.
  • Maths boxes that render LaTeX, such as $$\frac{-b \pm \sqrt{b^2-4ac}}{2a}$$.
  • Snap to shape: draw a line, circle, rectangle or triangle, then hold the pen still at the end and it turns into a clean shape. A snapped line can be aimed before you lift, and a highlighter stroke snaps to a straight underline.
  • Lasso: circle things with the pen to select them, then drag them together.
  • Graphs: type x^2 - 3 or 2sin(x) and the curve is drawn. You can also add shaded areas (y > x^2), vertical lines (x = 3) and named points ((1, 2) A). The trace tool reads values off a curve as you drag across it.
  • Charts you type the numbers into: press the chart button, say how many bars there are, type a name and a number for each, and choose the lowest and highest number up the side. Bar, line and pie charts, up to four sets of numbers, with side and bottom labels. Double-click a chart to change it. The command Insert a chart into this note puts the same kind of chart into a note as a picture.
  • Layers: stack parts of a board, hide or lock each layer, rename and reorder them, and move a selection onto another layer. You can also lock single items so they can't be moved or erased.
  • Ruler and protractor: drag them into place, turn them with the round handle (they click into 15° steps), and draw close to an edge for a perfectly straight line. The ruler shows its length in cm. Fingers and the mouse move the tools, and the Pencil draws against them.
  • Images from your device, camera, clipboard, the vault, or by drag and drop. Images are saved in your attachments folder. iPhone HEIC photos are converted to JPEG automatically (on iPad, iPhone and macOS).
  • Grid, dots, lined or plain backgrounds, plus undo and redo (⌘Z / ⇧⌘Z, or Ctrl+Z / Ctrl+Y).

Slides (.mslides)

  • Presentations where every slide works like a drawing board.
  • 11 ready-made layouts: Title slide, Title & bullets, Two columns, Compare, Section header, Equation, Worked example, Graph, Picture & text, Big statement and Blank.
  • Themes: Classic, Dark, Chalkboard, Ocean, Sunset, Paper and Midnight (colours and fonts for the whole deck), plus a font choice (clean, serif, rounded, handwriting, typewriter).
  • Transitions (fade, slide, zoom, rise) and one click at a time: show bullets, or each object, as you click through.
  • Slide thumbnails, speaker notes, and full-screen presenting with the keyboard, taps or swipes.
  • Draw while presenting: pen, highlighter and laser pointer on top of the slide (P, H, L, clear with C). Drawings stay with their slide until you finish.

Spreadsheets (.xlsx)

  • Opens and saves real Excel files.
  • Formulas with cell references and ranges, and around 55 functions, including SUM, AVERAGE, POWER, SQRT, trigonometry, logarithms, statistics and IF.
  • A big grid to start with (200 rows and columns A to AZ) that keeps growing as you move past the edge.
  • Resize rows and columns by dragging their edges. Sizes are saved in the file.
  • Formatting: bold, italic, text and fill colours, alignment, and number formats (currency, percent, decimals, scientific).
  • Drag to fill: drag the small square on the selection to continue numbers (1, 2 gives 3, 4, 5), weekdays and months, text such as Item 1, and formulas with their references moved.
  • Charts: select cells and make a bar, line, pie or scatter chart. Charts update as you change the numbers, and can be saved as an image to use on a note, board or slide.
  • Function suggestions as you type a formula, AutoSum, click a cell to add it to a formula, multiple sheets, copy and paste, and copy as a Markdown table.
  • A switch for keyboard autocorrect and predictions.
  • Share any note, drawing board, slide deck, spreadsheet, PDF or picture as a web link: right-click it in the file list and choose Share as a link, press the share button at the top of a board or deck (or Share in a spreadsheet's toolbar), or run Share this file as a link. You need to be signed in with Keyring (see Cloud sync).
  • Choose Keep it up to date with my changes or Share a copy of it as it is now, then press Make link and copy it and send the link to anyone. Links live at obsidian.leroyw1e.workers.dev and open in any web browser, phones too.
  • What people see:
    • Notes: formatted, with maths, pictures, tables, callouts and highlights. Links to your other notes show as plain text.
    • Boards: drawn exactly as they look, with pan and zoom.
    • Slides: one slide at a time with Next and Back (or the arrow keys, or a swipe), in the deck's theme with its transitions.
    • Spreadsheets: formulas worked out, colours, bold, alignment, number formats and sheet tabs. Charts aren't shown online.
    • PDFs and pictures: shown in the page, with a download button for PDFs.
  • Everything is view only, except spreadsheets, where you can also choose Edit. People change cells with the box at the top of the page. For a spreadsheet that's kept up to date, their changes come back into your spreadsheet within about 20 seconds while it's open (and on Sync now), and you get a message saying so. If a cell is changed in both places, the newest change wins. On a copy, their changes stay online only.
  • Editors must sign in (spreadsheets, optional): anyone can still look, but only people signed in with Keyring can make changes. Leave it off if you want anyone with the link to be able to edit.
  • Shared links in the Share menu, and Shared links in settings, list your links with Copy link, Change options and Stop sharing. Stopping sharing turns the link off straight away.
  • Links are long and random, so they can't be guessed, but anyone you send a link to can pass it on.

Maths in notes

  • Keyboard shortcuts for common maths (see below). You can turn them off in settings.
  • Type \ then a name, such as \alpha, \frac or \int, to search symbols with a live preview.
  • Symbols menu in the left sidebar, with Basics, Greek, Calculus, Functions, Matrices, Sets & logic and Geometry. Click where you want it, then tap a symbol. It also works for text boxes on boards.
  • Small raised numbers: type x^2 and it becomes x², 10^-3 becomes 10⁻³, and n^(n+1) becomes n⁽ⁿ⁺¹⁾. Only a ^ stuck to a number, letter or bracket is used, so block ids and footnotes are left alone, and it isn't used inside maths or code.
  • Auto solve: type a sum followed by = and the answer appears, for example 12*(3+4)= gives 84 and 3²+4²= gives 25. It also converts units: 5 km = gives 3.1069 miles, 100 F = gives °C, and 5 km to m = picks the unit you name. Lengths, weights, volumes, speeds, times and temperatures. If you'd rather check first, turn on Show the answer first, press Tab to use it and the answer appears faded after the =; Tab keeps it, and typing on ignores it.
  • Type pi for π: pi on its own becomes π (or \pi inside maths). Words like pie, spin and pizza are left alone, and so are links and tags. Delete a π and type pi again in the same place and it stays as plain pi.
  • Real × and ÷: 3*4 becomes 3×4 and 8/2 becomes 8÷2 as you type. Press Backspace straight after to get the plain * or / back (so 2/4 then a space still makes a fraction). Links, web addresses, dates and bold are left alone.
  • Number and symbol shortcuts: type 2/4 then a space for a fraction, sqrt(16) for a square root, and <=, >=, !=, +-, -> for ≤ ≥ ≠ ± →. Dates such as 1/2/2025 are left alone. Anything made of letters (Greek, integrals and so on) uses the symbols menu or the bottom row.
  • Fractions without braces: the fraction button opens a small box with a top and a bottom. A number just before the cursor becomes the top, and a selected 3/4 turns into a fraction straight away.
  • Maths buttons in the status bar on desktop and in the toolbar above the keyboard on mobile.

PDFs and photos into notes

  • Drag a PDF from Finder (or Files on iPad) onto the file list and it becomes a new note in that folder. Only the note is made: the PDF isn't kept, unless you've chosen to show the PDF itself or it had nothing in it to copy.
  • The note gets the PDF's text with its look kept: big text becomes headings, bold and italic stay, bullets and numbered lists become lists, and paragraphs run on across pages. Page numbers are left out, and there's a link back to the PDF at the end. Pictures in the PDF come into the note too, in the same place among the text (a picture used on every page, like a logo, is saved once). A scanned PDF, which is only pictures, comes in as its page pictures. In settings you can choose to always show the PDF itself.
  • Right-click a PDF already in your vault, or run Make a note from a PDF, to do the same.
  • Drop photos on the file list and they become one new note showing them all (named after the photo, or Photos and the date for several). iPhone HEIC photos are turned into JPEGs so they show on every device.
  • Dropping anything else on the file list works as normal.

Citations

  • A citation maker in its own tab: press the quote button in the left ribbon, or run Open citations.
  • Choose Website, Book, Journal article, Video or Newspaper or magazine and fill in the details, or paste a web address and press Fill in from link to fill them in for you.
  • Pick APA 7, MLA 9, Harvard or Chicago. Your list is kept in alphabetical order and changes style straight away.
  • Each citation shows its in-text version too, like (Smith, 2023), with buttons to copy, change or delete it.
  • Copy all copies the whole list with the italics kept, ready to paste into Word, Google Docs or PowerPoint. Add to slides adds References slides to one of your decks, and Add to note puts a References section at the end of a note.
  • Your Source lists: when you're signed in (see Cloud sync below), the list menu at the top of the Citations tab shows your lists from the Source website. Pick one to see and change it here; changes save to Source within a couple of seconds, and changes made on the website show up here within a minute (or press the sync button). New Source list… makes a list that also appears on the website, and the bin button deletes the open list in both places. In Obsidian is the list that only lives in this vault.

Pictures and tags in notes

  • Crop, move and wrap pictures (PNG, JPEG and other pictures): in Live Preview, click a picture for a small bar. Crop shows the whole picture right where it is, with a frame you drag (or pull by its edges and corners) over the part to keep; press Enter or Crop to finish, Escape to cancel. The picture file itself is never changed, so you can crop again or choose Whole picture later. Buttons also put the picture on the left or right with text flowing beside it, centre it, or make it bigger or smaller. Drag the picture to move it: the line you drop it on is where it goes, and the left, middle or right of the page decides whether it wraps on the left, is centred or wraps on the right. The choice is saved in the link (for example ![[photo.jpg|crop-10-0-25-5|left|300]]), so it looks the same in Reading view. iPhone HEIC photos you drop or paste into a note are turned into JPEGs. Dragging pictures in and the paperclip (attach) button are Obsidian's own.
  • Folder tags: new notes and notes you move get tags for the folders they're in. A note in School work/Maths gets #school-work and #maths, and when it moves the old folder tags come off. Run Tag all notes with their folders to add them to the notes you already have (it asks first).

Cloud sync (optional)

  • Sign in with Keyring: in Settings → Bits and Bobs → Cloud sync, press Sign in with Keyring. Your browser opens the Keyring sign-in page (passkey, email or an auth code), then comes back to Obsidian. If Obsidian doesn't open by itself, paste the code shown on the page into Use code.
  • Choose what to sync: add the folders or files you want (or the whole vault). Nothing is synced until you choose something.
  • Sync now, or turn on Sync automatically to sync when Obsidian opens, every 5 minutes, and shortly after you change a synced file. Sign in on your other devices with the same account to get the same files.
  • Citations sync too, so your citation list is the same everywhere.
  • If a file was changed on two devices before syncing, both copies are kept: the other copy is saved next to it as name (conflict date).md.
  • Deleting a synced file on one device moves it to the trash on the others.
  • Each Keyring account can store up to 2 GB, and single files up to 60 MB. A sign-in lasts 30 days, then you sign in again.

Sync your whole vault with OneDrive (optional)

  • In Settings → Bits and Bobs → Cloud sync, set Keep synced files in to OneDrive. By default everything in the vault is synced: every note, attachment, board, slide deck, spreadsheet, PDF and picture, in every folder, including new folders. Use Leave out these folders or files to skip some, or switch What to sync to Only folders and files I choose.
  • Your files go straight between your devices and your own OneDrive, not through Keyring. Citations and share links still use Keyring.
  • Each vault gets its own OneDrive folder: Apps → (the name you gave your app) → the vault's name. Several vaults can sync side by side. On a new device (an iPad, say), connect OneDrive, press Change next to OneDrive folder for this vault, and pick the vault you want. An empty vault then downloads everything.
  • Also sync settings, themes and plugins (on by default) includes the vault's settings folder (.obsidian): your settings, themes, snippets, hotkeys and installed plugins with their own settings, so a new device looks the same. Window layout (workspace*.json), caches and the trash always stay on each device, and so does this plugin's own data.json, so your OneDrive sign-in is never uploaded or copied to another device; connect OneDrive on each device. Other plugins' settings are synced as they are, so if one of them keeps a key or password in its settings, that goes to your OneDrive too. Turn this off if you'd rather not.
  • The first sync is safe. If both sides already have files, they're merged: files that are the same are left alone, files only on one side are copied across, and where a file differs, both versions are kept (the OneDrive one is saved next to yours as name (conflict date).md). Nothing is deleted on the first sync, and you get a summary like "uploaded 12, downloaded 340, 2 conflicts kept".
  • Deletions only spread when a file was in step at the last sync and then removed on one side. A file deleted on OneDrive goes to your Obsidian trash (as set in Obsidian's files settings, the vault's .trash by default); a file deleted here goes to the OneDrive recycle bin. If one sync would delete more than 20 files (and over a third of them), you're asked first when you press Sync now, and it's skipped when syncing automatically.
  • Big vaults: several files move at once, files over 4 MB are uploaded in pieces, a progress message shows while a lot of files are moving, and a dropped connection is retried. Whatever didn't finish is picked up by the next sync. Files over 100 MB, and files with names OneDrive can't store (such as ones with : or ?), are skipped.
  • When it runs: when Obsidian starts, every 5 minutes, about 30 seconds after you edit a file, and when you press Sync now, if Sync automatically is on. Changes to the settings folder are picked up by the next timed sync.
  • It works with personal Microsoft accounts (outlook.com, hotmail.com, live.com). Work and school accounts aren't supported.
  • One-time setup: make a free app ID. Microsoft needs this to let a plugin sign in to OneDrive. It takes a few minutes and you only do it once:
    1. Go to entra.microsoft.com, sign in with your Microsoft account, and open Entra ID → App registrations → New registration. (If it asks you to set up a free directory, accept.)
    2. Name it Bits and Bobs (that's the folder name you'll see in OneDrive). Under Supported account types choose Personal Microsoft accounts only. Leave the redirect address empty and press Register.
    3. On the page that opens, copy the Application (client) ID.
    4. Open Authentication (on the left), then Settings, and switch Allow public client flows to Yes. Press Save.
  • Back in Obsidian, paste the app ID into OneDrive app ID and press Connect OneDrive. A code appears: press Open the page, type the code at microsoft.com/devicelogin, and sign in. This works on iPad and iPhone too. Do this once in each vault on each device (you can use the same app ID everywhere).
  • Disconnect stops syncing and forgets the sign-in on this device. It doesn't delete anything in OneDrive or in your vault.

Editor tab (word counts and spelling)

  • Press the Editor button in the left sidebar (or run Open the Editor tab) to open a panel in the right sidebar for the note you're writing in. It updates as you type.
  • Words in big numbers, with an optional word goal and progress bar. Characters, characters without spaces, sentences, paragraphs, reading time, speaking time, words per sentence and how many different words you've used. Select some text to see how many words are in the selection.
  • How easy to read (a score out of 100 and a school grade), a warning about very long sentences, and the words you use a lot.
  • Spelling: every misspelled word with its corrections. Click a correction to put it in (a word that appears several times is fixed everywhere), click the word to jump to it in the note, ignore it for now, or add it to my words with the book button. It skips code, maths, web addresses, link targets, properties at the top, tags, acronyms and, if you like, names in the middle of a sentence.
  • Pick your dictionary in the panel or in settings: English for Australia, UK, US, Canada or South Africa. It's downloaded the first time you use it and kept on your device.

File history (go back to any moment)

  • Every save of your notes, drawing boards, slide decks and spreadsheets is recorded on your device, from the moment the feature is on. Nothing is uploaded: it's kept in the plugin's folder (history) and is left out of OneDrive sync.
  • Open it with the command Show the history of this file, by right-clicking a file and choosing File history, or with the File history button in the left sidebar. Browse the history of any file, including deleted ones lets you pick a file that's no longer in your vault.
  • Choose how finely to look with Year, Month, Day, Hour, Minute and Second. Each row shows how many saves there were and how many words were added and removed. Click a row to see what changed (added lines in green, removed lines in red, with the changed words picked out) or the whole version at the end of that period. The magnifier on a row looks inside it (a year becomes its months, then days, and so on), and the path at the top takes you back out.
  • Go back to the end of this period, Go back to just before it and Save a copy bring an old version back. Going back never throws anything away: the version you replaced stays in the history, so you can return to it.
  • For boards and decks the view summarises what was added, removed or moved, and for spreadsheets it lists the cells that changed; Save a copy opens that version as its own file. Spreadsheets are copied at most once every 10 seconds while you work. A file changed outside Obsidian, or while the plugin wasn't running, is noticed and marked.
  • In settings under File history you choose which kinds of file are kept (notes, boards and slides, spreadsheets, other text files), see how much space it uses, and can clear it. Text changes are stored as small differences, so even every save for years takes little room.

Canvas and embeds

  • Run Add a drawing card to this canvas and draw straight onto the card.
  • Embed a board, deck or spreadsheet in a note with ![[file.mboard]] to show it in place.

Keyboard shortcuts

Action macOS Windows / Linux
Inline maths $x$ ⌘⇧M Ctrl+Shift+M
Maths block ⌘⌥E Ctrl+Alt+E
Power x^y ⌘⌥P Ctrl+Alt+P
Subscript ⌘⌥B Ctrl+Alt+B
Fraction ⌘⌥Q Ctrl+Alt+Q
Square root ⌘⌥R Ctrl+Alt+R
Sum ⌘⌥S Ctrl+Alt+S
Integral ⌘⌥N Ctrl+Alt+N
Limit ⌘⌥L Ctrl+Alt+L
Matrix ⌘⌥X Ctrl+Alt+X
Symbol picker ⌘⌥K Ctrl+Alt+K
Greek letters ⌘⌥G Ctrl+Alt+G

On a board: P pen, H highlighter, E eraser, V select, S lasso, T text, M maths box, G graph, C trace, R O L A shapes, 1–6 colours, [ ] size, hold Space to pan, 0 to fit.

All commands can also be given your own hotkeys in Settings → Hotkeys.

Settings

The settings have two parts.

Features (at the top) has one switch for every major feature: drawing boards, slides, spreadsheets, maths typing and symbols, citations, the Editor tab, file history, picture tools, folder tags, PDF to note, photos to note, cloud sync with OneDrive and share links, showing boards, slides and spreadsheets inside notes and Canvas, ribbon buttons, and the Home + AI buttons. A feature you switch off disappears completely: its commands, menu items, buttons and tabs go, and nothing of it runs (cloud sync and sharing send nothing, and maths typing stops changing what you type).

Inside each feature has a heading for each feature with everything you can change for it, for example pen size, palm rejection and the toolbar tools for drawing boards; speaker notes and slide effects for slides; formatting, drag to fill and charts for spreadsheets; each typing helper for maths; the spelling language, your own words and word goal for the Editor tab; and the OneDrive and Keyring options for cloud sync. If a feature is switched off, its heading just says so and its options are hidden. The keyboard shortcuts table is at the bottom.

Notes

  • Spreadsheets keep your values, formulas, sheets, row and column sizes, and number formats in the Excel file. Bold, italic, colours, alignment and charts are saved on an extra hidden sheet named __bits_meta inside the file, so Excel won't show them. Cell colours made in Excel itself are not read.
  • Slides use their own format, and .pptx files can't be opened.
  • Optional integration: if the Home + AI plugin is installed, buttons for new boards, slides and spreadsheets are added to its home screen. You can turn this off in settings.
  • Privacy: no telemetry, and nothing is sent anywhere unless you use one of these:
    • Fill in from link in Citations reads that one web page.
    • File history is stored only on your device and never uploaded by this plugin.
    • File history is stored only on your device, in the plugin's folder. This plugin never uploads it, and OneDrive sync leaves it out.
    • Spell check downloads the dictionary you choose once, from this plugin's GitHub page (raw.githubusercontent.com). Your writing is checked on your device and never sent anywhere.
    • Cloud sync is off until you sign in. After you sign in to Keyring, only the folders and files you choose (or the whole vault, if you switch What to sync to everything), and your citation list (if Sync citations is on), are sent to the sync server at obsidian.leroyw1e.workers.dev (a Cloudflare Worker), where they're stored under your Keyring account so your other devices can get them. While you're signed in, the Citations tab also reads and saves your Source citation lists at source.leroyw1e.workers.dev (the Source website) when it's open or when you press Sync now. Signing in happens on Keyring (account.leroyw1e.workers.dev); the plugin never sees your password, only a sign-in token that's kept in the plugin's settings. If you turn on OneDrive sync, your vault's files (everything, or what you choose, and your settings folder unless you turn that off) are sent straight to your own OneDrive by Microsoft's service (login.microsoftonline.com and graph.microsoft.com), and nothing else is sent anywhere; the plugin keeps a Microsoft sign-in token in its settings until you press Disconnect. If you share something as a link, a copy of it (and any pictures it shows) is stored on the same server so the link works, and anyone with the link can see it; Stop sharing deletes it from the server. Shared pages load their Markdown, maths and PDF viewers from jsDelivr. Delete everything in the cloud removes your copy from the server (shared links too), and Sign out ends the sign-in.

More plugins

All my Obsidian plugins, with what they do and where to get them, are at obsidian.leroyw1e.workers.dev.

Installing manually

Copy main.js, manifest.json and styles.css from the latest release into <your vault>/.obsidian/plugins/bits-and-bobs/, then turn on Bits and Bobs in Settings → Community plugins.

Building

npm install
npm run build

Credits

Licence

MIT