Category:

Troubleshooting Export

June 1, 2024 in Uncategorized

Session Buddy’s export feature normally allows you to select a folder to save the export file to.

In some cases, however, folder selection may be unsupported or blocked by a permission setting. When this happens, Session Buddy falls back to a file download option. Most of the time this allows the export to proceed without issue, saving the export file to your preferred Downloads folder.

If you prefer to select a destination for your exports but it’s not offered as an option, or if you encounter a problem with the download fallback, there are a couple of things you can try to enable folder selection. Read on…

Enable file picker support

Some browsers such as Brave do not support a file picker feature by default. In these browsers, Session Buddy’s Export dialog displays a “Download file” button instead of a “Select destination” button.

To enable folder selection in this case, you may need to enable the File System Access API. You can do so by navigating to chrome://flags/#file-system-access-api and selecting Enabled from the dropdown of the highlighted item, then restarting the browser.

Note that while Session Buddy works fine in many browsers including Brave, it is currently only officially supported for use with Chrome.

Also, as with any Chrome flag, be sure to familiarize yourself with the implications of enabling this flag.

Allow file editing permission

In some cases, file selection may be blocked by a “File editing” permission.

When this is the case, Session Buddy will display an error after an attempt to select the file destination and present you with an option to download the file instead.

To enable folder selection in this case, you’ll need to explicitly allow the “File editing” permission.

To do this, open the web permissions page by right-clicking the Session Buddy icon, then selecting “View web permissions”. Alternatively, you can open a new tab and copy-paste the following URL into the address bar:

chrome://settings/content/siteDetails?site=chrome-extension%3A%2F%2Fedacconmaakjimmfgnblocblbcdcpbko

Scroll down to the “File editing” line item and change the permission from Block to Ask in the dropdown. Be sure to reload the Session Buddy tab before attempting to export again.

Sometimes this permission is locked by an enterprise policy, preventing you from changing it. If that’s the case you’ll need to contact your Google account administrator for help.

Data Safeguards

April 22, 2024 in Uncategorized

Session Buddy stores collections, history, and settings on your device.

This post explains the limitations inherent to this type of data storage and what you can do to guard against circumstances that can lead to data loss in some cases.

For a more in-depth analysis, see Understanding and Preventing Data Loss.

Extension local storage vulnerabilities

Data that a browser extension stores on your device can in some cases get deleted or corrupted due to circumstances beyond the extension’s control.

Some of the factors known to contribute to such data loss are:

  • Low disk space
  • Folders where the data is stored being deleted or corrupted by an external process such as:
    • OS cleaners (eg, CCleaner, Avast Cleanup)
    • anti-virus or anti-malware software
    • scheduled backups
    • Windows Restore
  • Browsing data or site data being cleared, automatically or intentionally
  • The extension being reset, disabled, or uninstalled by the browser
  • Browser profile corruption, possibly caused by a browser update or power outage
  • A browser or OS crash
  • Browser bugs
  • The usual risk factors associated with storing data in a single location, such as hardware failure and device theft

What you can do to protect your Session Buddy data

An opt-in cloud storage feature is currently in the works. This will, among other benefits, be the easiest and most reliable way to eliminate the risks related to storing data locally.

In the meantime, we recommend you follow the measures outlined below to give you the peace of mind of a data recovery option should you need it.

System backups

Include the local Session Buddy data folders in your scheduled system backups as outlined here.

Manual backups

Although less convenient, we recommend setting a daily, weekly, or monthly reminder to manually create a backup through Session Buddy’s Backup feature.

A backup file can be used to quickly restore your collections and history using Session Buddy’s Restore feature.

Mac Keyboard Shortcut Bug

March 20, 2024 in Uncategorized

The original Session Buddy v4 update mistakenly assigned the cmd+b keyboard shortcut to opening a new Session Buddy tab.

This is almost certainly not what you want, since cmd+b is a common keyboard shortcut in other applications.

While this was quickly corrected in a follow-up release, you may need to reset this shortcut manually.

To reset the keyboard shortcut:

  1. In Session Buddy, click on the gear menu in the upper right-hand corner, then click “Settings
  2. In the Settings dialog, click the “Other” tab
  3. Click the “Open extension shortcuts” button. This opens the Chrome extension keyboard shortcuts page.
  4. Scroll to the Session Buddy card and click the pencil icon next to the shortcut labeled “Activate the extension
  5. Click outside of the shortcut text box and make sure the shortcut reads “Not set

Session Buddy v4 FAQ

March 13, 2024 in Uncategorized

Session Buddy v4 introduced a lot of important features and enhancements, but also some changes to the UI that may have caught long-time users off guard.

While these changes were necessary, we could have done a better job communicating them and explaining why they were being made.

We’ve been listening carefully to your feedback since v4 landed and have been busy rolling out follow-up releases to address your concerns.

We’re committed to continuing our active engagement with our user community to help us understand what remains to be done and how to further improve your experience.

This page was created to answer some of your most common questions and concerns about Session Buddy v4. If there’s anything you’d like to discuss that’s not addressed below, please feel free to post in the user forum. We read every inquiry and make our best effort to respond quickly and meaningfully.

Where did Previous Sessions go?

Previous Sessions have been moved to the History panel. You can access the panel by clicking on the This Browser tile, then clicking the History button on the right.

What if my data did not automatically transfer from v3?

The upgrade to Session Buddy v4 includes an automatic data migration from a deprecated database technology to the modern standard.

While the vast majority of users were able to take advantage of this automatic data migration, those upgrading after having upgraded to Chrome 124 (much more likely now than when Session Buddy v4 was first released) will need to transfer data manually due to Chrome deprecations.

To transfer your v3 data manually, follow the steps outlined here: https://sessionbuddy.com/restore-v3-data/

Where is my favorite feature from v3?

The initial release of Session Buddy v4 left behind a handful of v3 features. These omissions were a strategic decision driven by time pressure imposed by impending Chrome deprecations. The alternative would have been to delay the release, putting a significant number of users’ data at risk—an unacceptable option.

While this situation was less than ideal, we did our best to mitigate the impact by prioritizing cuts based on usage data and other signals. We also developed a plan to rapidly restore these features. We’ve already issued multiple follow-up releases reinstating most of the missing functionality and are actively continuing to address remaining regressions.

Why does CMD+B open Session Buddy?

This was a mistake. An immediate follow-up (v4.0.1) was released to fix this.

In some cases the shortcut binding may still need to be reset manually. If necessary, follow these instructions: https://sessionbuddy.com/mac-shortcut-bug/

Why can I no longer just click an “x” to close a tab?

Session Buddy v4 introduced the ability to select tabs and links, enabling powerful new capabilities such as opening, closing, or copying multiple tabs at once. As part of this new feature, the “x” was replaced by a checkbox to facilitate selection of individual items.

In response to demand, a follow-up release (v4.0.2) added an opt-in setting (under Settings > Other) to revert this change to once again allow tabs/links to be closed/deleted with a single-click.

A future release will likely remove the need for this setting and show both an “x” and a checkbox on each item by default.

Note that regardless of whether the “x” is present, selected tabs can always be closed either by hitting the Delete key or right-clicking them and clicking Delete.

Pro tip: holding the Shift key while closing/deleting suppresses confirmation. You can also disable these confirmations altogether in settings.

Why does opening lots of tabs from Session Buddy sometimes take a long time?

Prior to v4.0.3, tab loading was automatically optimized if a lot of tabs were being opened at once. Optimizations included suspending tabs and delaying tab load.

After v4.0.3, these optimizations were disabled by default. They can be opted into as needed in Settings > Tabs.

If you choose to turn on tab opening optimization, there are 2 localStorage values that can be added to tweak the behavior:

nxs.experiment.optimized-open-threshold : number of tabs opened after which delay and suspending optimizations kick in, default 60

nxs.experiment.optimized-open-delay : number of ms to delay each open, kicks in after threshold number of tabs have been opened, default 100

To edit localStorage:

  1. Open an SB tab
  2. Hit F12 to open dev tools
  3. Click on the Application tab
  4. Expand the Local storage item on the left
  5. Select the chrome-extension item underneath
  6. Double-click in the area to the right to create a new entry
  7. Enter the relevant nxs.experiment key above
  8. Hit Tab
  9. Enter a numeric value
  10. Hit Tab or Enter

Google “chrome devtools localstorage” for more info.

Why does destination selection fail when exporting?

In Session Buddy v4, the export feature normally allows for the selection of a folder to save the export file to.

In some cases, however, folder selection may be unsupported or blocked by a permission setting.

When this happens, Session Buddy as of v4.0.4 falls back to a download option to allow the export to proceed, saving the export file to your preferred Downloads folder.

This limitation primarily affects users of the Brave browser since Brave disables the File System Access API by default.

To learn about enabling folder selection if blocked, see: https://sessionbuddy.com/troubleshooting-export/

Why are tab counts no longer displayed on tiles?

Counts on collection and history tiles were eliminated because of technical complexity related to tab filtering and ultimate support for cloud-based collections, our most-requested feature.

We may bring this back in some form based on feedback.

We recommend using expressive titles when possible to help identify collections rather than relying on tab counts.

Restore

March 12, 2024 in Uncategorized

When you re-install Session Buddy, you can transfer your collections and history from a backup file created with a previous install by using the Restore feature. You can find Restore in the Session Buddy gear menu.

Restore presents a dialog that you can drag a backup file into. After you drop the file into the gray area, Session Buddy checks it and displays the number of collections and history items found.

Once Session Buddy is done checking the file, click the “Restore” button and wait for the restore to finish.

After closing the dialog, your restored collections and history will appear in Session Buddy.

Why not use Import?

Import and export are intended to make it easy to share collections between Session Buddy and other applications or people. As such, they do not include history.

Backup and Restore, on the other hand, include history as well as other data needed to initialize a new install of Session Buddy.

Key differences:

  • Backup and Restore include both collections and history. Import and Export only include collections.
  • Restore only creates collections that have not already been restored. Import, on the other hand, will always create new collections, which could result in duplication when the same file is imported again.
  • Restore preserves pinned collections, whereas Import removes pins from collections.

Tab Open Permissions

January 21, 2024 in Support Topics

If you see an error notification in Session Buddy when trying to open links in a collection, it’s probably because some of the links you’re trying to open require special permission. This notification is most commonly encountered when trying to open local or incognito links.

Local links

Opening local links (i.e., links with URLs that start with file:///) requires the Allow access to file URLs permission to be turned on in Session Buddy’s extension settings.

If this permission is not turned on, trying to open these kinds of links will display a notification letting you know that they failed to open.

To grant the permission, right-click the Session Buddy extension icon in the toolbar and then click “Manage extension”. On the Session Buddy details page, turn on the Allow access to file URLs toggle.

Incognito links

Opening links that are in an incognito folder requires the Allow in Incognito permission to be turned on in Session Buddy’s extension settings.

If this permission is not turned on, trying to open these kinds of links will display a notification letting you know that they failed to open.

To grant the permission, right-click the Session Buddy extension icon in the toolbar and then click “Manage extension”. On the Session Buddy details page, turn on the Allow in Incognito toggle.

Alternatively, if you want to open links in an Incognito folder as non-incognito tabs, you can change the folder to be a non-incognito folder. To do so, right-click the folder, click Edit, uncheck the Incognito checkbox, and click OK.

Browser feature links

Links to browser features like bookmarks, history, settings, or extensions are never allowed to be opened in an incognito window, even when the Allow in Incognito permission is enabled.

Session Buddy Browser Compatibility

November 6, 2023 in Support Topics

Due to upcoming changes in Chrome, Session Buddy now requires Chrome (or Edge) version 110 or newer.

If you see a notification in the app warning about this, it means you’re on an old browser version that needs to be updated in order for Session Buddy to continue to receive updates that keep it functioning.

You MUST upgrade Chrome (or Edge) to at least version 110 before March 1, 2024 to avoid being stuck with an old and unsupported version of Session Buddy.

If you wait until after March 1, 2024 to upgrade your browser, you will lose all of your Session Buddy saved sessions when you upgrade.

Also note that while existing installs of Session Buddy will continue to run on versions of Chrome older than 110, it will soon become impossible to install or re-install Session Buddy without first upgrading to Chrome 110 or newer.

WHAT YOU SHOULD DO NOW

1. Back up your saved sessions

Click on the Session Buddy gear icon, then click Back up.

It’s generally a good idea to do this often, and especially before making big changes.

A backup can later be imported into Session Buddy to recover saved sessions if necessary.

2. Include the Session Buddy data file in your system backups

Locate the Session Buddy data file by following the steps outlined here: How to Locate Session Buddy Data on Your Computer

Ensure that this file is included in your scheduled system backups. If you aren’t regularly backing up your computer, drop everything you’re doing and make this a priority. You’ll thank me later.

3. Ensure you’re on the latest version of Chrome (or Edge)

If this is not currently possible, make sure you’re backing up often. You’ll eventually need a recent backup to transfer your data when you re-install Session Buddy or Chrome updates it.

Once you’re on a compatible browser version, the compatibility notification in the app will disappear.

Local File Permissions

November 1, 2023 in Support Topics

Due to a change in Chrome 118, opening URLs for local files (i.e., URLs that start with file:///) now requires extensions to have the “Allow access to file URLs” permission turned on in the extension’s settings.

If this permission is not turned on, local file URLs will be ignored when restoring tabs. In addition, you’ll see this message at the top of saved sessions that contain local file URLs:

To grant the permission, go to Session Buddy’s extension settings and turn on the following toggle:

To get to the settings page, you can either right-click the Session Buddy extension icon in the toolbar and then click “Manage extension” or copy-paste the following URL into the address bar:

chrome://extensions/?id=edacconmaakjimmfgnblocblbcdcpbko

Troubleshooting

April 16, 2017 in Support Topics

This article outlines the first steps to take if you encounter a problem while using Session Buddy.

1.  Save your data

Begin by backing up your Session Buddy data:

  • Using Session Buddy’s Backup Feature: Click the gear icon in Session Buddy and select “Backup” to save your collections and history. See Backup and Restore.
  • If Session Buddy Won’t Open: Use the saveData() console command to download a file containing all collections and history.
  • Manual Backup: If the above methods fail, manually copy the Session Buddy data folders to a safe location.

2.  Restart the browser

Ensure a complete shutdown of your browser before restarting:

On Windows: Close all browser windows. Then check the tool tray for the browser icon. If it is present, right-click it and click “Exit“.

On macOS: Press Cmd+Q to quit the browser. Then check the Dock for the browser icon. If it’s still there, right-click and choose “Quit” if available.

After restarting, check if the issue persists. If it does, proceed to the next step.

3.  Consult the support page

Visit the Session Buddy Support Page for solutions to common issues. It’s likely you’ll find the assistance you need there.

If you’re unable to find an answer, contact support.

Locate Session Buddy Data on Your Device

April 16, 2017 in Support Topics

Session Buddy v3 (the old version) and Session Buddy v4 (the current version) store data in different places on your computer.

If you are looking for the data location for the current version of Session Buddy (v4), click here

If you are looking for the data location for the old version of Session Buddy (v3), click here