JSPM

scrapbook-cli

1.0.4
    • ESM via JSPM
    • ES Module Entrypoint
    • Export Map
    • Keywords
    • License
    • Repository URL
    • TypeScript Types
    • README
    • Created
    • Published
    • 0
    • Score
      100M100P100Q15105F
    • License MIT

    A CLI tool for viewing and managing your scrapbook entries

    Package Exports

    • scrapbook-cli
    • scrapbook-cli/index.mjs

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (scrapbook-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    πŸš€ Scrapbook CLI

    A cyberpunk-inspired, terminal-based interface for your digital scrapbook. Dive into your memories, search through your digital artifacts, and relive your online adventures - all from the comfort of your command line.

    Screenshot 2024-07-07 at 10 32 56 PM Screenshot 2024-07-07 at 10 32 44 PM

    🌟 Features

    • πŸ“š Browse your entire scrapbook collection
    • πŸ” Full-text search across all entries
    • πŸ–₯️ Slick, cyberpunk-themed UI
    • ⚑ Lightning-fast navigation
    • πŸ”— Quick-copy links to clipboard
    • 🌐 Open entries directly in your browser
    • πŸ“Š Visual type indicators for different entry sources
    • πŸ—ΊοΈ Mini-map view for entries with location data
    • 🌍 Full-screen map view of all geotagged entries
    • πŸ“‹ JSON export for individual scraps

    πŸ› οΈ Installation

    npm install -g scrapbook-cli

    πŸš€ Usage

    To launch the Scrapbook CLI in list mode:

    scrapbook-cli list

    To view the full-screen map of all geotagged entries:

    scrapbook-cli --map

    To get JSON data for a specific scrap:

    scrapbook-cli json <scrap_id>

    πŸ•ΉοΈ Controls (List Mode)

    • ↑/↓ or j/k: Navigate entries
    • β†’: Copy public URL to clipboard
    • ←: Copy entry URL to clipboard
    • Space: Open entry in browser
    • z: Toggle full-screen summary view
    • / or s: Search entries
    • r: Refresh entries
    • PageUp/PageDown: Move 24 entries at a time
    • Esc: Exit search or full-screen view
    • q: Quit

    πŸ•ΉοΈ Controls (Map Mode)

    • ↑/↓: Navigate through map markers
    • q: Quit

    πŸ—ΊοΈ Mini-Map Feature

    The mini-map displays the location of the currently selected entry if it has latitude and longitude data. If an entry doesn't have location data, the mini-map will be hidden.

    🌍 Full-Screen Map View

    The full-screen map view shows all your geotagged entries on a world map. Navigate through the markers to see details about each entry.

    πŸ“‹ JSON Export

    Use the json command followed by a scrap ID to get the full JSON data for that specific scrap. This is useful for debugging or data export purposes.

    πŸ”§ Configuration

    Scrapbook CLI uses environment variables for configuration. Create a .env file in your home directory with the following:

    SUPABASE_URL=your_supabase_url
    SUPABASE_KEY=your_supabase_key

    🀝 Contributing

    Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

    πŸ“œ License

    MIT

    πŸ™ Acknowledgements

    Built with love, caffeine, and a dash of cyberpunk nostalgia. Special thanks to the creators of blessed, blessed-contrib, and Supabase for making this CLI possible.

    Remember, in the neon-lit world of digital scrapbooking, you're the protagonist of your own cyberpunk story. Happy scrapping! πŸŒ†πŸ’Ύ