Skip to content

qretadev/later

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

QLater CLI

Content management CLI with Meilisearch for books, videos, and links.

Features

  • Smart Add: Auto-detects content type from URLs
  • Unified Commands: Single commands for all item types
  • Platform Detection: Recognizes 50+ platforms
  • Full-text Search: Powered by Meilisearch

Installation

npm install && npm run build && npm link

Requirements

  • Node.js 20+
  • Meilisearch: meilisearch --master-key=later-master-key --db-path ~/.local/share/qlater/meili_data

Commands

add

qlater add <url>                           # Auto-detect type
qlater add <isbn>                          # Book by ISBN
qlater add "Title" --book --author "Name"  # Book by title

# Options
qlater add <input> --watch                 # Force as video
qlater add <input> --read                  # Force as link
qlater add <input> --title "Title"
qlater add <input> --priority 1
qlater add <input> --tags a,b

ls

List and search items:

qlater ls                                  # All items
qlater ls --all                            # All (including completed)
qlater ls --books                          # Only books
qlater ls --videos                         # Only videos
qlater ls --links                          # Only links

# Filters
qlater ls --status pending|start|done|archive
qlater ls --priority 1-3
qlater ls --tags rust,web

# Search
qlater ls "query"
qlater ls "rust" --books

# Output
qlater ls --json
qlater ls --simple

update

qlater update <id> --start                 # In progress
qlater update <id> --done                  # Completed
qlater update <id> --archive               # Archive
qlater update <id> --rm                    # Delete
qlater update <id> --title "Title"
qlater update <id> --priority 1
qlater update <id> --add-tags a,b
qlater update <id> --remove-tags a

tags

qlater tags list                           # All tags
qlater tags show <tag>                     # Items with tag
qlater tags rename <old> <new>
qlater tags delete <tag>

status

qlater status                              # Full system status
qlater status --config                     # Configuration only
qlater status --stats                      # Statistics only
qlater status --json                       # JSON output

config

qlater config set meiliHost http://localhost:7700
qlater config set defaultPriority 3
qlater config reset --force

backup

qlater backup export > backup.jsonl        # Export to stdout
qlater backup export backup.jsonl          # Export to file
qlater backup import backup.jsonl          # Import from file
qlater backup import backup.jsonl -t video # Import as videos

General

qlater sync --books                        # Sync metadata

Quick Reference

Task Command
Add qlater add <url>
List qlater ls
List books qlater ls --books
Search qlater ls "query"
Start qlater update <id> --start
Done qlater update <id> --done
Delete qlater update <id> --rm
Tags qlater update <id> --add-tags a,b
Status qlater status
Backup qlater backup export backup.jsonl

Supported Platforms

Video: YouTube, Vimeo, Twitch, Dailymotion Movies/TV: Netflix, Prime Video, HBO Max, Disney+ Books: OpenLibrary, Goodreads, Amazon Music: Spotify, Apple Music, SoundCloud Learning: Udemy, Coursera, edX Dev: GitHub, GitLab, Stack Overflow Articles: Medium, Substack, Dev.to, Reddit

License

MIT

About

Add items for later viewing

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors