BrainTool - Go Beyond Bookmarks

Organize all your bookmarks, web resources and notes into a personal Topic hierarchy and control your browser with the BrainTool Topic Manager. Open and close browser tabs, windows and tab groups with a click or navigate using powerful keyboard commands. Capture links and notes while in context on a web page. Allocate each of your Topics to its own window or tab group for a focused workspace.

Tame your browser tabs, focus your attention and never be afraid to close a tab again!

Your BrainTool data is private, it's your personal information space that the BrainTool application reads from a plain text file completely under your control. It's written in the popular Org-Mode format and so can fit within any larger text-based workflow. Back it up, copy it, share it - it's just a text file that you own.

Import from bookmarks, Org files or Tabs Outliner, sync automatically to Google Drive or a local file. BrainTool is 100% browser based, so your data never leaves your control.

"Every Google Chrome user should try this...Bring your bookmarks into the 21st century" - ZDNet
"I've used Session Buddy and OneTab. This is far superior." - User Review
"As a current Tabs Outliner user, my first reaction is that BrainTool, even in its pre-1.0 release, is far more polished." - User Review

BrainTool is hard to summarize. Its a way-better bookmarks manager, but it's also a browser manager, a tabs manager and a session manager. It's a replacement for tools like Tabs Outliner, but it's mostly a personal knowledge management system that allows you to organize all of your online information sources (web sites, Google docs, gmails, files, photos, Slack channels, social media groups, code repos, wiki pages, task backlogs, Jupyter notebooks, etc etc etc), combine them with your text-based notes and see the big picture in the tree structured side panel. It's the plain text bookmarking tool that I always wanted to exist but could never find, so I built it. I hope you like it!


------- RELEASE NOTES --------
# BrainTool 1.0.2
A small point release with unfinished business from 1.0 and updates based on 1.0 feedback
## Feature Updates
- Added topic expansion on hover so folded topics can be dropped into (thanks @rocketman455 for the suggestion!)
- Improvements to the upgrade process to make it clearer whats happening.
- Added trial expiration and initial nagging 30 days after installation.
- GitHub #32: When TopicMgr is in a tab - don't navigate on item deletion. If the browser is maximized don't adjust its position on first opening TM.

## Fixes
- Better handling for gdrive cert expiry on save when Google Authorization popup is blocked.
- GutHub #33: Fixed regex to not clobber org properties.
- Improvements to tracking sticky tabs.
- Various refactoring and error handling housekeeping.

# Welcome to BrainTool 1.0!
Here is an overview of whats new.
## Manifest V3
This change is not of great interest to a BT user but is mandated by Google and required non-trivial code changes.

## Full Tab Group Support
One advantage of the manifest update is that it provides access to the tabgroup api so that BT can provide full synchronization between Topics and browser tabgroups. By default Topics are now shown as tabgroups in the browser. Tabs opened from BT open in a tabgroup labelled with the appropriate Topic. In the Topic Manager open links and Topics are highlighted with the tabgroups color. Changing the tabgroups color in the browser is reflected in the Topic Manager. Name changes and expand/collapse operations are also synced.

Additionally dragging a tab into a tabgroup will save that tab into the Topic in BT. Dragging a saved tab out of its tabgroup will remove it from BrainTool.

## Sticky Tabs
When 'Sticky Tabs' is enabled the relationship between a tab and an associated saved item in the Topic Manager is maintained when you click a link in the saved tab or during a server side redirection. This allows you to navigate around a saved site or app, or get redirected to a different url (for example to a log-in page) while staying in the context of the original saved BT Item.

## Topic Tree visuals
The expand/collapse buttons and the favicon displays have been restyled, and an empty topic is now visually distinct. It is hoped that these changes make the tree structure easier to see, in addition to improving the styling in general.

## Session saving and Bookmarker Updates
The BT Bookmarker now has the option to save a whole tabgroup (if the current tab is in one), and a complete session, in addition to the previous window and tab options. When saving a session, tab groups are saved as the corresponding BrainTool Topic. Any ungrouped tabs are put in a tabgroup named with a Window-N prefix and saved under a Topic with the same name in the Topic Manager. The Session itself is given a Session-date Topic name and saved under the Topic selected in the Bookmarker or the Scratch default Topic.

## Preferences for Dense, Hide Notes, Tooltips and Large Font
New preferences have been added for these items.

## New Introductory Screens
We've added a helpful BrainTool Buddy to give a gentle introduction to BT when it's initially installed and at launch thereafter, until turned off.

## GDrive Auth Change
Another Google mandated update is the change to use their Auth 2.0 libraries for Google Drive authorization. Unfortunately the access provided to browser-based apps (ie those without a back-end server) is considered to be temporary access and to require explicit user interaction. If you have GDrive saving turned on you'll be warned in the red warning banner when the token expires. You can click to immediately re-auth or ignore it and re-auth will happen on the next save.

## Usability Improvements
- Rows in the Topic Manager can now be dragged by selecting anywhere on the row
- The Tab key now iterates a selected Topic through three states: collapsed, open with its child nodes showing and open with its children all fully expanded.
- Search has been improved to make it easier to see the current match and other visible matches.

## Pricing and License Changes for 1.0
- There will be no limits on numbers of nodes saved in BT (other than those due to browser storage limits)
- In addition to monthly and yearly subscriptions a one-time purchase lifetime license will be offered with pricing as follows:
- Monthly $1.33/mo, Yearly $10.66/yr, Lifetime $21
- This (low, low) pricing reflects my goal of having BT be widely used and to encourage users to support its development. The extra change over $1/$10/$20 covers the Stripe transaction costs.
- License enforcement will be as follows:
- 30 days all access.
- After 30 days messages of gentle encouragement will be shown at intervals.
- Functionally some setting preferences will be locked (Dark mode, Favicons etc) but otherwise the app will be fully functional.

# 0.9.9a
This was a minor point release because there are no changes requiring updates on the Web Stores, but it has some major functionality!

## Local File Sync
Local file sync opens up a lot of potential for saving, versioning and backing up your BrainTool data. The file location used by BrainTool can be hooked up to DropBox, a git repository or any other cloud syncing mechanism.

Local sync is mutually exclusive with GDrive syncing, you can only sync to one place. Syncing can be turned on via the Settings screen (click the new Settings icon, top right). If you are already syncing to GDrive and want to change you will first need to turn off GDrive syncing (via 'Actions', again top right). On initiation you will be asked to select a folder for BT to access. The browser will ask you to grant permission first for Read-only access to the folder and then for read-write access.

The ability to write to a local file from a web app is a newish capability and heavily secured within the browser. Every time you re-open the BT Topic Manager you will need to re-grant permissions for BT to write to the local folder. Note that the **Brave** browser developers need to enable via a browser configuration setting.

## Settings, Actions and Help panels
The previous overlay panel put access to settings behind multiple mouse clicks and was confusing for many users. We've broken out those functions into separate panels which can be accessed directly from the top level Topic Manager. Settings and Actions are top right, Help is bottom right. Other than Local file sync, the available settings and actions are unchanged.

## Tips, Messages and Warnings
A colored panel below the topic tree now shows any required informational messages on startup and subsequently provides access to a set of tips on BT usage. If a sync file is out of date the panel shows a 'Warning' message and provides a shortcut to the refresh function with a single click.

## Minor UI changes
In addition to the above:
- Some colors have been tweaked to improve contrast and readability.
- The application as a whole now does a better job of handling wide and narrow Topic Manager windows.
- The topic card editor makes better use of space and use a fixed width font to improve org-mode compatibility.

## Telemetry
While your privacy is a key aspect of the BrainTool value proposition and we do not have any access to your data, we do need to collect some information on how the application itself is being used. On startup the app now records (to Google Analytics) the number of saved topics and pages, the number of file saves/updates, the number of tab operations performed, the number of times you've launched the app, days since install and how long your last session of using it was.

# Welcome to BrainTool 0.9.9
## New Look and Feel including a Dark Mode
I completely revamped the BT fonts and color palette and added a dark mode - the most requested feature.

## Re-organized Saver Tool
I made another iteration on whats been called the bookmarker or popup to make it easier to understand while keeping it fast and efficient for both mouse and keyboard users. Additionally, any number of nested new topics can now be created from the Saver e.g. setting the topic to Animal:Vertebrate:Mammal:Carnivore:Canid:Dog:Hound:Beagle will create 8 levels of topic if they don't already exist.

## Compact Mode
Another highly requested feature. Shrinking the Topic Manager to less than 350 pixels wide hides the notes column for a highly compact and information dense display of your saved topics and pages.

## "Open in New Window" Tool
You can now open a page, or complete topic, in a new window. The previous mapping of topics to windows has been removed as being too complicated. You can choose to have BT manage your tabs, grouping them into tab groups, or not, thus leaving them wherever you or the browser puts them. BT will no longer confuse you by moving tabs between windows.

## "Add Top Level Topic" Tool
Available at the top of the Topic Manager. Hopefully this one is self-explanatory.

## Topic Manager window remembers its position
The Topic Manager now opens with the same size and position as it had when it was last closed.

## GDrive Refresh Button
If you have GDrive syncing turned on, the Refresh button is now available in the top toolbar whenever BT detects that there is a newer file available.

## Topic Tree imports
A correctly formatted org-mode file will now import its contents into the appropriate nesting in the tree. See https://braintool.org/topicTrees.

## Other Usability and Misc Improvements
I removed the counter for number of saves (top right) because its no longer part of the pricing model. Lots of improvements were made in areas like the card editor, the initial topic tree, the initial placement of the topic manager etc.

# BrainTool 0.9.8
## New Bookmarker
To address some confusion and to make the 'popup' more usable I've re-designed it from the ground up and done some rebranding. I'm now calling the popup 'Bookmarker'. Clicking the BT icon (or Opt/alt-b) now opens the Bookmarker showing the note card for the page with the Notes field selected. You can still just hit enter to move on without adding a note, for speed. This new card editor also allows you to edit the page title and it's where you can select to save all tabs or just the active one.

On exit the card editor opens the topic selector. This was also reworked to show a clearer view of your topic hierarchy. The hierarchy starts partially open and subtopics can be opened, closed and selected with your mouse. Auto complete works as before, just start typing. The previous 'Group', 'Stick', 'Close' options have been reduced to a selector for 'Group' or 'Close'. The selector remembers its start and defaults to that the next time around.

## Skip the Topic!
By popular demand I added a 'Scratch' topic. If you leave the topic selector empty the page (or pages) will be added under the Scratch topic. This means you can save a page, or all pages in the window, by bringing up the Bookmarker and hitting Enter twice, the first creates the note card with an empty note, the second saves the page under Scratch.

## Update existing note cards in the Bookmarker
With this new bookmarker design I was able to add the ability to edit the notes and title for existing saved pages. Opening the Bookmarker for a page already saved to BT will open it's note card and save any updates. (NB changing its topic still needs to be done in the Topic Manager.)

## Side Panel is now Topic Manager and can run in a tab
The term 'Side Panel' did not make sense to folks so its been renamed to Topic Manager. Based on a suggestion from Crimson K and validation from Timothy, I added an option for the Topic Manager to run in a browser tab rather than the current side panel. Its not optimized for this form factor and for me it works better as a panel off to the side of my browser tabs but it seemed worth adding to support a full-page-on-top type setup. From Options, change 'Topic Manager in:' from 'Side Panel' to 'Tab', wait a few seconds for it to save, then close the Topic Manager. When you relaunch, the Topic Manager will open in a regular browser tab. If you use it in this mode I'd be interested in feedback over in the discussion group.

## Performance Improvements
Thanks to Timothy for stressing BT with his six thousand plus bookmarks! A small tweak to avoid a low level recalculation of layout for every table row added resulted in a significant speed up on first start with a big braintool.org file. Search got similar performance attention and should now be snappier.

## Search Improvements
Thanks to Peter for his detailed feedback on Search. Improvements include better key handling on Linux, being able to 'escape' key out of search, restoring previous selection on failed search and a few other bug fixes.

## Space key
Also based on Peter's feedback, the space key will now open a tab for the selected item if its not already open, and highlight it if it is open.

# BrainTool 0.9.7
## Search
See the new User Guide for details, or just try playing with it and let me know what you think.

## Best effort mapping of open tabs to saved links on startup
## Selection in tree now tracks highlighted tab in browser
## Onboarding and usability updates

# Earlier releases

## Support for Edge and Brave browsers
Edge users can get BrainTool at the Edge store. Brave users can install from the Chrome store.
## File Import/Export
In addition to Chrome Bookmarks, 0.9 adds the ability to import from a TabsOutliner export and also to import a text file with org-mode markup.
## org-mode Support
BrainTool should now retain any org markup in the BrainTool.org file (or an imported file).
## Keyboard shortcuts
## Ability to tag all a windows tabs at once
## Statistics Bar