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.
: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
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.