-
Notifications
You must be signed in to change notification settings - Fork 0
Bookmarks & History
Complete guide to managing your browsing data in NaviDuck. Learn how to save, organize, and revisit your favorite content efficiently.
- Bookmarks Overview
- Managing Bookmarks
- History Management
- Import/Export Data
- Data Organization
- Privacy & Security
- Troubleshooting
- Pro Tips
Bookmarks in NaviDuck are saved links to webpages you want to revisit quickly. Unlike browser bookmarks, they're stored locally in a simple JSON file for privacy and portability.
~/.naviduck_data.json # On Linux/Mac
%USERPROFILE%/.naviduck_data.json # On Windows
Each bookmark contains:
- Title: Page title (auto-extracted)
- URL: Full webpage address
- Added: Timestamp of when saved
- Tags: (Future feature) Categories/labels
- Notes: (Future feature) Personal notes
When viewing any webpage, press b:
Page Actions:
b - Bookmark this page
o - Open in browser
s - Search related
h - Back to history
q - Return to main
You'll be prompted for a custom title or can use the auto-detected one.
After a search, type b to bookmark the first result:
Select an option:
1-10 - Open result in NaviDuck
o1-o10 - Open result in browser
b - Bookmark first result
Enter - Return to search
bookmark add <URL>Examples:
bookmark add https://python.org
bookmark add github.com
bookmark add "https://docs.python.org/3/tutorial/"history
# View list, note the number of item you want to bookmark
bookmark add <URL from history>bookmarksDisplays:
📚 Bookmarks (5 total)
1. 📑 Python Official Website
https://python.org
Added: 2024-01-15 14:30:22
──────────────────────────────────────
2. 📑 GitHub
https://github.com
Added: 2024-01-14 09:15:47
(Future feature - for now, use grep)
bookmarks | grep pythonbookmarks
# Then type the number (1, 2, 3, etc.)open b1 # Open bookmark #1 in browser
go b2 # Open bookmark #2 in NaviDuck# Current method: Delete and re-add
bookmark delete 3
bookmark add <url> "New Custom Title"Bookmarks are automatically sorted by most recently added. Manual sorting is a planned future feature.
While you can't add categories yet, you can use naming conventions:
[Python] Official Documentation
[Tools] GitHub Repository
[Learning] Python Tutorial
[Reference] Cheat Sheets
bookmark delete <number>Example:
bookmarks # Note the number to delete
bookmark delete 3# Delete one by one
bookmark delete 1
bookmark delete 2
# etc.# From settings menu
settings
# Choose option 6 (Clear bookmarks)# View count (shown in bookmarks list)
bookmarks
# Shows: "📚 Bookmarks (X total)"- Search queries (what you searched for)
- Visited pages (URLs you accessed)
- Timestamps (when activity occurred)
- Engine used (for searches)
- Tor usage (if accessed via Tor)
historyDisplays last 15 items:
🕰️ Browsing History (42 total items)
1. 🔍 DuckDuckGo: python tutorial
2024-01-15 14:45:22
──────────────────────────────────────
2. 📄 Python Official Website
https://python.org
2024-01-15 14:46:10
History shows last 15 items by default. All history is stored (up to 100 items) and can be viewed in the data file.
# Currently view and search manually
history | grep pythonhistory
# Type the number to revisit that page/searchhistory
# Find a previous search, type its number
# It will re-execute that searchReview your history to see:
- What topics you research frequently
- Which sites you visit often
- Your browsing patterns and habits
Currently, you can only clear all history, not individual items.
# Method 1: From settings
settings
# Choose option 5 (Clear history)
# Method 2: Direct command
history clear- Maximum 100 history items stored
- Oldest items are automatically removed when limit reached
- Search and visit history combined in same limit
# View in main menu
# Shows: "🕰️ History: X entries"bookmark exportCreates: naviduck_bookmarks_YYYYMMDD.json
[
{
"title": "Python Official Website",
"url": "https://python.org",
"added": "2024-01-15T14:30:22",
"type": "bookmark"
}
]Copy the .naviduck_data.json file:
cp ~/.naviduck_data.json ./backup_bookmarks.jsonbookmark import <filename.json>- Export bookmarks from your browser as HTML
- Convert to NaviDuck JSON format (tool planned)
- Import using
bookmark import
Replace or merge with .naviduck_data.json:
cp ./my_bookmarks.json ~/.naviduck_data.jsonHistory is stored in the same file as bookmarks. Export the entire data file:
cp ~/.naviduck_data.json ./naviduck_backup.json- Separate history export
- CSV export for spreadsheets
- Filtered exports (by date, type, etc.)
# Create backup script
echo 'cp ~/.naviduck_data.json ~/.naviduck_backup_$(date +%Y%m%d).json' > backup_naviduck.sh
chmod +x backup_naviduck.sh
./backup_naviduck.sh# Example using Google Drive (rclone)
rclone copy ~/.naviduck_data.json gdrive:naviduck_backups/# Track changes with git
cd ~
git init
echo ".naviduck_data.json" >> .gitignore
# Or track it if you want version history~/.naviduck_data.json
{
"history": [
{
"type": "search",
"query": "python tutorial",
"engine": "brave",
"timestamp": "2024-01-15T14:45:22",
"results": 10
},
{
"type": "visit",
"url": "https://python.org",
"title": "Python Official Website",
"timestamp": "2024-01-15T14:46:10",
"tor": false
}
],
"bookmarks": [
{
"title": "Python Official Website",
"url": "https://python.org",
"added": "2024-01-15T14:30:22"
}
]
}nano ~/.naviduck_data.json
# or
code ~/.naviduck_data.json# Backup first
cp ~/.naviduck_data.json ~/.naviduck_data_backup.json
# Create fresh file
echo '{"history": [], "bookmarks": []}' > ~/.naviduck_data.jsonUse a Python script or JSON merging tool to combine data from multiple instances.
# Manual process:
# 1. Export bookmarks
# 2. Use jq or Python to remove duplicates
# 3. Import cleaned file# Keep only last 30 days
# (Script needed - future feature)Data file is typically small (<100KB even with full history).
- No cloud sync - Your data stays on your machine
- No tracking - No one sees your browsing habits
- No accounts - No login required
- Encryption - File is plain JSON, you can encrypt it
# Set appropriate permissions
chmod 600 ~/.naviduck_data.json# Use encrypted filesystem
encfs ~/.naviduck_private ~/.naviduck_decrypted
# Or use git-crypt for version controlled encryption- Don't share your data file
- Clear history before sharing computer
- Export only specific bookmarks if needed
(Planned feature) Temporary session without saving history.
Choose what gets saved:
- Save searches but not visits
- Save visits but not searches
- Save nothing (full privacy mode)
- History auto-purge after X days
- Bookmark cleanup suggestions
- Duplicate detection and removal
Solutions:
# 1. Check file permissions
ls -la ~/.naviduck_data.json
# 2. Check disk space
df -h ~
# 3. Restart NaviDuck
quit
python naviduck.pySolutions:
# 1. Check if history is enabled
# (Always enabled currently)
# 2. Clear and restart
history clear
quit
python naviduck.pySolutions:
# 1. Check JSON format
python -m json.tool my_bookmarks.json
# 2. Check file permissions
chmod 644 my_bookmarks.json
# 3. Try manual copy
cp my_bookmarks.json ~/.naviduck_data.jsonSolutions:
# 1. Restore from backup
cp ~/.naviduck_backup.json ~/.naviduck_data.json
# 2. Create fresh file
echo '{"history": [], "bookmarks": []}' > ~/.naviduck_data.json
# 3. Re-import from export
bookmark import naviduck_backup.jsonsudo chown $USER:$USER ~/.naviduck_data.json
chmod 644 ~/.naviduck_data.json# Repair with Python
python3 -c "import json; data = json.load(open('.naviduck_data.json')); print('File is valid')"# Create fresh file
echo '{"history": [], "bookmarks": []}' > ~/.naviduck_data.json# Daily backup script
#!/bin/bash
cp ~/.naviduck_data.json ~/backups/naviduck_$(date +%Y%m%d).json
# Keep only last 7 days
find ~/backups -name "naviduck_*.json" -mtime +7 -delete# Weekly check
python3 -m json.tool ~/.naviduck_data.json > /dev/null && echo "OK" || echo "Corrupted"# Monthly cleanup of old history
# (Script needed - future feature)# Good:
Python 3.11 Documentation - Built-in Functions
# Bad:
docs
[Work] Project Documentation
[Work] Team Resources
[Learning] Python Courses
[Learning] Algorithm Practice
[Reference] Cheat Sheets
- Monthly review of bookmarks
- Remove dead links
- Archive old references
- Merge duplicates
# Weekly review
history | tail -50
# What did I research this week?
# What patterns do I see?# From frequent searches in history
alias searchpy="s python"
alias searchdocs="s python documentation"Use history to track:
- Time spent on research
- Learning progress
- Project research phases
# Track changes to bookmarks
cd ~
git init
git add .naviduck_data.json
git commit -m "Update bookmarks"# Using syncthing or similar
# Sync ~/.naviduck_data.json across computers# Share curated bookmarks
bookmark export --filter "python"
# Share with colleagues/students# Use bookmarks in scripts
python3 -c "
import json
with open('$HOME/.naviduck_data.json') as f:
data = json.load(f)
for bm in data['bookmarks']:
if 'python' in bm['title'].lower():
print(bm['url'])
"# Analyze browsing patterns
python3 -c "
import json
from collections import Counter
with open('$HOME/.naviduck_data.json') as f:
data = json.load(f)
# Most visited sites
urls = [h['url'] for h in data['history'] if h['type'] == 'visit']
print('Top sites:', Counter(urls).most_common(5))
"# Export to browser
# Convert NaviDuck JSON to Chrome HTML
# (Tool needed - future feature)# Clear sensitive history immediately
# Use settings -> Clear history# Different data files for different purposes
NAVIDUCK_DATA=~/.naviduck_work.json python naviduck.py
NAVIDUCK_DATA=~/.naviduck_personal.json python naviduck.py# Store data file in encrypted container
veracrypt --mount --password=xxx ~/naviduck_data.tc ~/.naviduck# From main menu:
# Bookmarks: X saved
# History: X entries- Bookmarks added per week
- Active research topics
- Most used search engines
- Time spent browsing
- Useful bookmarks ratio
- Search success rate
- Learning progress through history
- Folders/tags for bookmarks
- Smart categories auto-organization
- Search within bookmarks/history
- Sync with cloud services
- Import from browsers
- Export to various formats
- Visualizations of browsing patterns
- Collaborative bookmark sharing
- Rating system for bookmarks
- Annotations on saved pages
- Reminders to revisit bookmarks
- Duplicate detection automatic
- Backup scheduler automated
- Privacy controls granular
- Command Reference - All bookmark/history commands
- Search Guide - Effective searching that creates useful history
- AI Assistant - Using AI with your browsing data
- Troubleshooting - Solving data-related issues
- Backup regularly - Don't lose your curated collection
- Organize as you go - A little effort saves future cleanup
- Review periodically - Remove what you no longer need
- Export for sharing - Spread useful resources
- Respect privacy - Clear sensitive data promptly
"Your bookmarks and history are your digital memory. Keep them organized, and they'll serve you for years."
Q: Where are my bookmarks stored?
A: ~/.naviduck_data.json (in your home directory)
Q: How many bookmarks can I save? A: No technical limit, but performance stays good up to thousands.
Q: Can I sync across devices? A: Not automatically, but you can manually copy the data file.
Q: How long is history kept? A: Up to 100 items, then oldest are auto-removed.
Q: Is my browsing data private? A: Yes! It's stored locally on your machine only.
Q: Can I import Chrome/Firefox bookmarks? A: Not directly yet, but planned for future versions.
Q: What happens if the data file gets corrupted? A: NaviDuck will create a fresh one, but you'll lose existing data.
Q: Can I password-protect my bookmarks? A: Not currently, but you can store the file in an encrypted volume.
"A well-organized digital library is a treasure. NaviDuck helps you build yours."
# Try these now:
bookmarks # Review your collection
history # See your browsing patterns
bookmark export # Backup your dataHappy organizing! 📚✨
Last updated: 12/22/2025
Bookmarks & History Guide version: 2.0