Skip to content

Bookmarks & History

Jump to bottom
Dragon edited this page Dec 23, 2025 · 2 revisions

📚 Bookmarks & History Guide

Complete guide to managing your browsing data in NaviDuck. Learn how to save, organize, and revisit your favorite content efficiently.

📋 Table of Contents

🏷️ Bookmarks Overview

What are Bookmarks?

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.

Bookmark Storage Location

~/.naviduck_data.json  # On Linux/Mac
%USERPROFILE%/.naviduck_data.json  # On Windows

Bookmark Structure

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

📌 Managing Bookmarks

Adding Bookmarks

Method 1: While Viewing a Page

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.

Method 2: From Search Results

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

Method 3: Direct Command

bookmark add <URL>

Examples:

bookmark add https://python.org
bookmark add github.com
bookmark add "https://docs.python.org/3/tutorial/"

Method 4: From History

history
# View list, note the number of item you want to bookmark
bookmark add <URL from history>

Viewing Bookmarks

List All Bookmarks

bookmarks

Displays:

📚 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

Search Within Bookmarks

(Future feature - for now, use grep)

bookmarks | grep python

Opening Bookmarks

From Bookmarks List

bookmarks
# Then type the number (1, 2, 3, etc.)

Direct Open by Number

open b1  # Open bookmark #1 in browser
go b2    # Open bookmark #2 in NaviDuck

Organizing Bookmarks

Edit Bookmark Title

# Current method: Delete and re-add
bookmark delete 3
bookmark add <url> "New Custom Title"

Sort Bookmarks

Bookmarks are automatically sorted by most recently added. Manual sorting is a planned future feature.

Group by Category

While you can't add categories yet, you can use naming conventions:

[Python] Official Documentation
[Tools] GitHub Repository
[Learning] Python Tutorial
[Reference] Cheat Sheets

Deleting Bookmarks

Delete Single Bookmark

bookmark delete <number>

Example:

bookmarks      # Note the number to delete
bookmark delete 3

Delete Multiple Bookmarks

# Delete one by one
bookmark delete 1
bookmark delete 2
# etc.

Clear All Bookmarks

# From settings menu
settings
# Choose option 6 (Clear bookmarks)

Bookmark Statistics

# View count (shown in bookmarks list)
bookmarks
# Shows: "📚 Bookmarks (X total)"

🕰️ History Management

What's Stored in History

  • 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)

Viewing History

Basic History View

history

Displays 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

View More History

History shows last 15 items by default. All history is stored (up to 100 items) and can be viewed in the data file.

Search History

# Currently view and search manually
history | grep python

Using History

Revisit Previous Pages

history
# Type the number to revisit that page/search

Repeat Searches

history
# Find a previous search, type its number
# It will re-execute that search

Learn from Patterns

Review your history to see:

  • What topics you research frequently
  • Which sites you visit often
  • Your browsing patterns and habits

Clearing History

Clear Specific Item

Currently, you can only clear all history, not individual items.

Clear All History

# Method 1: From settings
settings
# Choose option 5 (Clear history)

# Method 2: Direct command
history clear

Automatic History Limits

  • Maximum 100 history items stored
  • Oldest items are automatically removed when limit reached
  • Search and visit history combined in same limit

History Statistics

# View in main menu
# Shows: "🕰️ History: X entries"

📤 Import/Export Data

Export Bookmarks

Export to JSON

bookmark export

Creates: naviduck_bookmarks_YYYYMMDD.json

Export Format Example

[
  {
    "title": "Python Official Website",
    "url": "https://python.org",
    "added": "2024-01-15T14:30:22",
    "type": "bookmark"
  }
]

Manual Export

Copy the .naviduck_data.json file:

cp ~/.naviduck_data.json ./backup_bookmarks.json

Import Bookmarks

From Previous Export

bookmark import <filename.json>

From Browser Export

  1. Export bookmarks from your browser as HTML
  2. Convert to NaviDuck JSON format (tool planned)
  3. Import using bookmark import

Manual Import

Replace or merge with .naviduck_data.json:

cp ./my_bookmarks.json ~/.naviduck_data.json

Export History

Current Method

History is stored in the same file as bookmarks. Export the entire data file:

cp ~/.naviduck_data.json ./naviduck_backup.json

Planned Features

  • Separate history export
  • CSV export for spreadsheets
  • Filtered exports (by date, type, etc.)

Backup Strategy

Regular Backups

# 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

Cloud Backup

# Example using Google Drive (rclone)
rclone copy ~/.naviduck_data.json gdrive:naviduck_backups/

Version Control

# Track changes with git
cd ~
git init
echo ".naviduck_data.json" >> .gitignore
# Or track it if you want version history

🗂️ Data Organization

File Structure

Data File Location

~/.naviduck_data.json

File Contents

{
  "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"
    }
  ]
}

Manual Data Management

Edit Data File Directly

nano ~/.naviduck_data.json
# or
code ~/.naviduck_data.json

Repair Corrupted Data

# Backup first
cp ~/.naviduck_data.json ~/.naviduck_data_backup.json

# Create fresh file
echo '{"history": [], "bookmarks": []}' > ~/.naviduck_data.json

Merge Multiple Data Files

Use a Python script or JSON merging tool to combine data from multiple instances.

Data Cleanup

Remove Duplicates

# Manual process:
# 1. Export bookmarks
# 2. Use jq or Python to remove duplicates
# 3. Import cleaned file

Archive Old History

# Keep only last 30 days
# (Script needed - future feature)

Optimize File Size

Data file is typically small (<100KB even with full history).

🔒 Privacy & Security

Local Storage Benefits

  • 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

Security Considerations

File Permissions

# Set appropriate permissions
chmod 600 ~/.naviduck_data.json

Encryption Options

# Use encrypted filesystem
encfs ~/.naviduck_private ~/.naviduck_decrypted

# Or use git-crypt for version controlled encryption

Sharing Concerns

  • Don't share your data file
  • Clear history before sharing computer
  • Export only specific bookmarks if needed

Privacy Features

Incognito Mode

(Planned feature) Temporary session without saving history.

Selective Saving

Choose what gets saved:

  • Save searches but not visits
  • Save visits but not searches
  • Save nothing (full privacy mode)

Automatic Cleanup

  • History auto-purge after X days
  • Bookmark cleanup suggestions
  • Duplicate detection and removal

🚨 Troubleshooting

Common Issues

"Bookmarks not saving"

Solutions:

# 1. Check file permissions
ls -la ~/.naviduck_data.json

# 2. Check disk space
df -h ~

# 3. Restart NaviDuck
quit
python naviduck.py

"History not showing recent items"

Solutions:

# 1. Check if history is enabled
# (Always enabled currently)

# 2. Clear and restart
history clear
quit
python naviduck.py

"Can't import bookmarks"

Solutions:

# 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.json

"Data file corrupted"

Solutions:

# 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.json

Error Messages

"Permission denied"

sudo chown $USER:$USER ~/.naviduck_data.json
chmod 644 ~/.naviduck_data.json

"Invalid JSON format"

# Repair with Python
python3 -c "import json; data = json.load(open('.naviduck_data.json')); print('File is valid')"

"File not found"

# Create fresh file
echo '{"history": [], "bookmarks": []}' > ~/.naviduck_data.json

Preventive Maintenance

Regular Backups

# 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

Integrity Checks

# Weekly check
python3 -m json.tool ~/.naviduck_data.json > /dev/null && echo "OK" || echo "Corrupted"

Cleanup Schedule

# Monthly cleanup of old history
# (Script needed - future feature)

⚡ Pro Tips

Bookmark Organization Tips

Use Descriptive Titles

# Good:
Python 3.11 Documentation - Built-in Functions

# Bad:
docs

Group Related Bookmarks

[Work] Project Documentation
[Work] Team Resources
[Learning] Python Courses
[Learning] Algorithm Practice
[Reference] Cheat Sheets

Regular Cleanup

  • Monthly review of bookmarks
  • Remove dead links
  • Archive old references
  • Merge duplicates

History Utilization Tips

Learn from Patterns

# Weekly review
history | tail -50
# What did I research this week?
# What patterns do I see?

Create Search Shortcuts

# From frequent searches in history
alias searchpy="s python"
alias searchdocs="s python documentation"

Productivity Tracking

Use history to track:

  • Time spent on research
  • Learning progress
  • Project research phases

Data Management Tips

Version Control

# Track changes to bookmarks
cd ~
git init
git add .naviduck_data.json
git commit -m "Update bookmarks"

Sync Across Devices

# Using syncthing or similar
# Sync ~/.naviduck_data.json across computers

Export for Sharing

# Share curated bookmarks
bookmark export --filter "python"
# Share with colleagues/students

Advanced Techniques

Scripting with Bookmarks

# 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'])
"

Analytics

# 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))
"

Integration with Other Tools

# Export to browser
# Convert NaviDuck JSON to Chrome HTML
# (Tool needed - future feature)

Privacy Tips

Regular Cleanup

# Clear sensitive history immediately
# Use settings -> Clear history

Separate Profiles

# Different data files for different purposes
NAVIDUCK_DATA=~/.naviduck_work.json python naviduck.py
NAVIDUCK_DATA=~/.naviduck_personal.json python naviduck.py

Encryption

# Store data file in encrypted container
veracrypt --mount --password=xxx ~/naviduck_data.tc ~/.naviduck

📊 Statistics & Insights

View Your Stats

# From main menu:
# Bookmarks: X saved
# History: X entries

Growth Tracking

  • Bookmarks added per week
  • Active research topics
  • Most used search engines
  • Time spent browsing

Productivity Metrics

  • Useful bookmarks ratio
  • Search success rate
  • Learning progress through history

🔮 Future Features

Planned Enhancements

  • 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

Community Requests

  • Rating system for bookmarks
  • Annotations on saved pages
  • Reminders to revisit bookmarks
  • Duplicate detection automatic
  • Backup scheduler automated
  • Privacy controls granular

📚 Related Resources

💡 Final Wisdom

Golden Rules for Data Management

  1. Backup regularly - Don't lose your curated collection
  2. Organize as you go - A little effort saves future cleanup
  3. Review periodically - Remove what you no longer need
  4. Export for sharing - Spread useful resources
  5. Respect privacy - Clear sensitive data promptly

Remember:

"Your bookmarks and history are your digital memory. Keep them organized, and they'll serve you for years."

❓ FAQ

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 data

Happy organizing! 📚✨

Last updated: 12/22/2025
Bookmarks & History Guide version: 2.0

Clone this wiki locally