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

Adding a Link¶

Go to Settings > External Links
Click Add Link
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

Click Save

Managing Links¶

Reordering¶

Drag links to change their order in the sidebar:

Hover over a link
Grab the drag handle
Drag to new position
Release

Editing¶

Click the edit icon on a link
Modify any field
Click Save

Deleting¶

Click the delete icon
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.

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

Admins can set a default sidebar navigation order that applies to all users who haven't customized their own.

Setting a Default¶

Arrange the sidebar items in your preferred order (drag to reorder)
Go to Settings > General > Sidebar Order
Toggle Set Default on

The current sidebar order is saved as the default for all users.

How It Works¶

Scenario	Behavior
New user	Automatically gets the admin-set order
User hasn't customized	Gets the admin-set order on next page load
User has customized	Keeps their own order (admin default is not re-applied)
Admin toggles off	Default is cleared; existing user orders are unchanged

Permission Required

The Set Default toggle is only visible to users with Settings: Update permission (settings:update).

One-Time Application

The default order is applied once per user. If you update the default, users who already received a previous default will not be affected. To re-apply, users can click Reset on their sidebar order first.

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.