Skip to content

External Links

Add custom links to external tools and resources in your Bambuddy sidebar navigation.


Overview

External links let you:

  • Quick access to related tools
  • One-click to Spoolman, OctoPrint, etc.
  • Customize your workflow
  • Keep everything accessible

  1. Go to Settings > External Links
  2. Click Add Link
  3. Fill in the details:
Field Description
Name Display name (e.g., "Spoolman")
URL Full URL including protocol
Icon Select an icon
Show in Sidebar Toggle sidebar visibility
Open in New Tab Open link in new tab
  1. Click Save

Reordering

Drag links to change their order in the sidebar:

  1. Hover over a link
  2. Grab the drag handle
  3. Drag to new position
  4. Release

Editing

  1. Click the edit icon on a link
  2. Modify any field
  3. Click Save

Deleting

  1. Click the delete icon
  2. Confirm deletion

Icons

Available Icons

Choose from Material Design icons:

Icon Name Good For
:material-spool: Spool Spoolman, filament
Printer OctoPrint, Mainsail
Chart Analytics, Grafana
Cog Settings, config
GitHub Repositories
Document Documentation
Home Dashboards
Link Generic links

Custom Icons

Additional icons available in the icon picker.


:material-sidebar: Sidebar Display

Visibility

Toggle Show in Sidebar to control visibility:

  • Shows in sidebar navigation
  • Hidden (accessible from settings)

Position

Links appear in the sidebar below the main navigation items.

Appearance

Links display with:

  • Icon (if selected)
  • Name
  • External indicator (if opens new tab)

Use Cases

Spoolman

Link to your filament inventory:

Field Value
Name Spoolman
URL http://192.168.1.50:7912
Icon :material-spool:
Sidebar Yes
New Tab Yes

OctoPrint / Mainsail

Link to printer web interfaces:

Field Value
Name Mainsail
URL http://192.168.1.100
Icon
Sidebar Yes
New Tab Yes

Grafana Dashboard

Link to monitoring dashboards:

Field Value
Name Grafana
URL http://grafana:3000/d/printers
Icon
Sidebar Yes
New Tab Yes

Documentation

Link to manuals or wikis:

Field Value
Name Docs
URL https://github.com/maziggy/bambuddy-wiki
Icon
Sidebar Yes
New Tab Yes

Printables / Thingiverse

Quick access to model sites:

Field Value
Name Printables
URL https://www.printables.com
Icon
Sidebar Yes
New Tab Yes

Keyboard Shortcuts

External links can be accessed via keyboard:

  • Links are assigned numbers after main navigation
  • Press the assigned number to navigate

Shortcut Assignment

External link shortcuts start after built-in page shortcuts.


Backup Integration

External links are included in backups:

  • Exported with database backup
  • Restored when importing backup
  • No manual re-entry needed

Backup & Restore


Tips

Related Tools

Add links to tools you use alongside Bambuddy for quick switching.

Open in New Tab

Enable "New Tab" to keep Bambuddy open while visiting links.

Organize by Usage

Put most-used links at the top via drag-and-drop.

Keep It Clean

Hide rarely-used links from sidebar to reduce clutter.