light-phone-cli-tui 0.1.0__tar.gz

light_phone_cli_tui-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+__pycache__
+*.pyc
+_build
+.env
+.venv
+tests/fixtures/
+.coverage

light_phone_cli_tui-0.1.0/PKG-INFO

@@ -0,0 +1,12 @@
+Metadata-Version: 2.4
+Name: light-phone-cli-tui
+Version: 0.1.0
+Summary: Unofficial CLI/TUI for the Light Phone
+Author-email: Alexis Garado <alexisgarado@proton.me>
+Requires-Python: >=3.11
+Requires-Dist: click
+Requires-Dist: light-phone-api
+Requires-Dist: pyperclip
+Requires-Dist: rich
+Requires-Dist: rich-click
+Requires-Dist: textual

light_phone_cli_tui-0.1.0/light_cli_tui/cli.py

@@ -0,0 +1,595 @@
+"""
+█░░ █ █▀▀ █░█ ▀█▀   █▀▀ █░░ █   ▄█▄   ▀█▀ █░█ █
+█▄▄ █ █▄█ █▀█ ░█░   █▄▄ █▄▄ █   ░▀░   ░█░ █▄█ █
+
+Command line tools for Light devices.
+"""
+
+import logging
+import time
+import rich_click as click
+from rich.console import Console
+from rich.progress import Progress, TaskID, TextColumn, BarColumn, TaskProgressColumn
+from rich.table import Table
+
+from light_api.client import Light
+from light_api.music import SortMode
+from light_api.tools import ToolName
+from light_api import with_light
+from light_cli_tui.tui import LightConfig, run_tui
+
+
+click.rich_click.USE_RICH_MARKUP = True
+click.rich_click.USE_MARKDOWN = True
+click.rich_click.SHOW_ARGUMENTS = True
+click.rich_click.GROUP_ARGUMENTS_OPTIONS = True
+click.rich_click.STYLE_COMMANDS_TABLE_COLUMN_WIDTH_RATIO = (1, 3)
+
+console = Console()
+log = logging.getLogger(f"light.{__name__}")
+
+
+@click.group()
+@click.option("--email", default=None, help="Light account email address.")
+@click.option("--email-file", default=None, help="Path to file containing email.")
+@click.option("--password", default=None, help="Light account password.")
+@click.option("--password-file", default=None, help="Path to file containing password.")
+@click.option("--phone-number", default=None, help="Phone number.")
+@click.option(
+    "--phone-number-file", default=None, help="Path to file containing phone number."
+)
+@click.option(
+    "--log-level",
+    default="WARNING",
+    type=click.Choice(["DEBUG", "INFO", "WARNING", "ERROR"], case_sensitive=False),
+    help="Log level.",
+)
+@click.pass_context
+def cli(
+    ctx,
+    email,
+    email_file,
+    password,
+    password_file,
+    phone_number,
+    phone_number_file,
+    log_level,
+):
+    """**Unofficial CLI for the Light Phone.**
+
+    Manages music, podcasts, and notes on your Light device from the terminal.
+
+    Credentials can be provided via options, files, or environment variables
+    (`LIGHT_EMAIL`, `LIGHT_PASSWORD`, `LIGHT_PHONE_NUMBER`).
+    """
+    logging.basicConfig(format="%(name)s %(levelname)s %(message)s")
+    logging.getLogger("light").setLevel(log_level.upper())
+
+    ctx.ensure_object(dict)
+    ctx.obj.update(
+        {
+            "email": email,
+            "email_file": email_file,
+            "password": password,
+            "password_file": password_file,
+            "phone_number": phone_number,
+            "phone_number_file": phone_number_file,
+        }
+    )
+
+
+@cli.group()
+def music():
+    """Music library management.
+
+    Upload tracks, delete them, sort your playlist, and update metadata.
+    """
+    pass
+
+
+@cli.group()
+def podcast():
+    """Podcast management.
+
+    Add podcasts by RSS feed URL and remove ones you no longer want.
+    """
+    pass
+
+
+@cli.group()
+def notes():
+    """Notes management.
+
+    List, add, download, and watch for changes to text and audio notes.
+    """
+    pass
+
+
+# -- Podcast commands ----------------------------------------------------------
+
+
+@podcast.command("add")
+@with_light
+@click.argument("rss_feed_url")
+def podcast_add(light: Light, rss_feed_url):
+    """Subscribe to a podcast by RSS feed URL.
+
+    The server resolves the title and publisher automatically from the feed.
+
+    **Example:**
+
+    `light podcast add https://feeds.simplecast.com/FO6kxYGj`
+    """
+    p = light.podcast.add_podcast(rss_feed_url)
+    console.print(f"[green]Added:[/green] {p.title or rss_feed_url}")
+    if p.publisher:
+        console.print(f"[dim]Publisher:[/dim] {p.publisher}")
+
+
+@podcast.command("list")
+@with_light
+def podcast_list(light: Light):
+    """List all followed podcasts on your device."""
+    podcasts = light.podcast.get_podcasts()
+
+    if not podcasts:
+        console.print("[dim]No podcasts followed.[/dim]")
+        return
+
+    table = Table(show_header=True)
+    table.add_column("#", style="dim", width=4)
+    table.add_column("Title")
+    table.add_column("Publisher")
+
+    for i, p in enumerate(podcasts, 1):
+        table.add_row(str(i), p.title, p.publisher)
+
+    console.print(table)
+
+
+@podcast.command("delete")
+@with_light
+@click.argument("title")
+def podcast_delete(light: Light, title):
+    """Unfollow a podcast by title.
+
+    Uses exact title matching. Run `light podcast list` to see titles.
+    """
+    podcasts = light.podcast.get_podcasts()
+    matches = [p for p in podcasts if p.title == title]
+
+    if not matches:
+        console.print(f"[yellow]No podcast found with title: {title}[/yellow]")
+        return
+
+    for p in matches:
+        console.print(f"  {p.title}")
+    if not click.confirm("Unfollow?"):
+        return
+
+    light.podcast.delete_podcast_by_title(title)
+
+
+# -- Music commands -------------------------------------------------------------
+
+
+@music.command("upload")
+@with_light
+@click.argument("songs", nargs=-1, required=True)
+@click.option(
+    "--allow-duplicates",
+    is_flag=True,
+    help="Skip duplicate checking and always upload.",
+)
+@click.option(
+    "--match-title-by",
+    "-m",
+    type=click.Choice(["filename", "metadata"]),
+    default="metadata",
+    show_default=True,
+    help="How to match existing tracks when checking for duplicates.",
+)
+@click.option(
+    "--no-convert-flac",
+    is_flag=True,
+    default=False,
+    help="Skip FLAC to MP3 conversion (conversion is on by default to preserve metadata).",
+)
+def music_upload(light: Light, songs, allow_duplicates, match_title_by, no_convert_flac):
+    """Upload one or more audio files to your device.
+
+    Duplicate detection is on by default - existing tracks with a matching
+    title will be replaced. Use `--allow-duplicates` to skip this.
+
+    **Example:**
+
+    `light music upload track1.mp3 track2.mp3`
+    """
+    files = list(songs)
+
+    if not allow_duplicates:
+        from mutagen._file import File as MutagenFile
+        import os as _os
+
+        if match_title_by == "metadata":
+            titles = []
+            for s in files:
+                f = MutagenFile(s, easy=True)
+                titles.append(
+                    f.get("title", [_os.path.splitext(_os.path.basename(s))[0]])[0]
+                    if f
+                    else _os.path.splitext(_os.path.basename(s))[0]
+                )
+        else:
+            titles = [_os.path.splitext(_os.path.basename(s))[0] for s in files]
+
+        existing = light.music.get_tracks()
+        to_overwrite = [t for t in existing if t.title in set(titles)]
+
+        if to_overwrite:
+            console.print(f"Tracks to overwrite ({len(to_overwrite)}):")
+            for t in to_overwrite:
+                console.print(f"  {t.artist} — {t.title}")
+            if not click.confirm("Proceed?"):
+                return
+
+    with Progress(
+        TextColumn("[progress.description]{task.description}"),
+        BarColumn(),
+        TaskProgressColumn(),
+        console=console,
+    ) as progress:
+        task_id: TaskID | None = None
+        current_file: str | None = None
+
+        def on_progress(filename: str, sent: int, total: int) -> None:
+            nonlocal task_id, current_file
+            if filename != current_file:
+                if task_id is not None:
+                    progress.update(task_id, completed=100)
+                current_file = filename
+                task_id = progress.add_task(f"uploading {filename}", total=100)
+            progress.update(task_id, completed=int(sent / total * 100))
+
+        light.music.upload_tracks(
+            files,
+            allow_duplicates=allow_duplicates,
+            match_title_by=match_title_by,
+            convert_flac=not no_convert_flac,
+            on_progress=on_progress,
+        )
+
+
+@music.command("delete-all")
+@with_light
+def music_delete_all(light: Light):
+    """Delete ALL tracks on device."""
+    if not click.confirm("This will delete ALL tracks on the device. Proceed?"):
+        return
+
+    if input('Type "yes i am sure" to confirm: ') != "yes i am sure":
+        return
+
+    light.music.delete_all_tracks()
+
+
+@music.command("delete")
+@with_light
+@click.argument("songs", nargs=-1, required=True)
+def music_delete(light: Light, songs):
+    """Delete tracks by title.
+
+    Uses exact title matching. Run `light music list` to see track titles.
+
+    **Example:**
+
+    `light music delete "Song Title" "Another Song"`
+    """
+    titles = list(songs)
+    tracks = light.music.get_tracks()
+    to_delete = [t for t in tracks if t.title in set(titles)]
+
+    if not to_delete:
+        console.print("[yellow]No matching tracks.[/yellow]")
+        return
+
+    console.print(f"Tracks to delete ({len(to_delete)}):")
+    for t in to_delete:
+        console.print(f"  {t.artist} — {t.title}")
+    if not click.confirm("Proceed?"):
+        return
+
+    light.music.delete_tracks_by_title(titles)
+
+
+@music.command("sort")
+@with_light
+@click.argument("field", type=click.Choice(["artist", "title", "artist-album", "none"]))
+@click.option(
+    "--asc",
+    "order",
+    flag_value="ascending",
+    default=True,
+    help="Sort ascending (default).",
+)
+@click.option("--desc", "order", flag_value="descending", help="Sort descending.")
+def music_sort(light: Light, field, order):
+    """Sort tracks by artist, title, or reset to manual order.
+
+    `none` resets to the manual ordering you set in the app.
+
+    **Examples:**
+
+    `light music sort artist --desc`
+
+    `light music sort title`
+
+    `light music sort none`
+    """
+    descending = order == "descending"
+
+    if field == "artist":
+        light.music.set_sort_mode(
+            SortMode.ARTIST_DESC if descending else SortMode.ARTIST_ASC
+        )
+    elif field == "title":
+        light.music.set_sort_mode(
+            SortMode.TITLE_DESC if descending else SortMode.TITLE_ASC
+        )
+    elif field == "artist-album":
+        light.music.set_sort_mode(
+            SortMode.ARTIST_ALBUM_DESC if descending else SortMode.ARTIST_ALBUM_ASC
+        )
+    elif field == "none":
+        light.music.set_sort_mode(SortMode.RANK)
+
+
+@music.command("update")
+@with_light
+@click.argument("title")
+@click.option("--new-title", default=None, help="New track title.")
+@click.option("--new-artist", default=None, help="New artist name.")
+@click.option("--new-album", default=None, help="New album name.")
+def music_update(light: Light, title, new_title, new_artist, new_album):
+    """Update metadata for a track.
+
+    Matches by exact title. At least one of `--new-title`, `--new-artist`, or `--new-album` must be provided.
+
+    **Example:**
+
+    `light music update "Old Title" --new-title "New Title" --new-artist "Artist" --new-album "Album"`
+    """
+    tracks = light.music.get_tracks()
+    matches = [t for t in tracks if t.title == title]
+
+    if not matches:
+        console.print(f"[yellow]No track found with title: {title}[/yellow]")
+        return
+
+    for track in matches:
+        light.music.update_track_metadata(
+            track.audio_id, title=new_title, artist=new_artist, album=new_album
+        )
+
+
+@music.command("list")
+@with_light
+def music_list(light: Light):
+    """List all tracks on your device."""
+    tracks = light.music.get_tracks()
+
+    table = Table(show_header=True)
+    table.add_column("#", style="dim", width=4)
+    table.add_column("Title")
+    table.add_column("Artist")
+    table.add_column("Album")
+
+    for i, track in enumerate(tracks, 1):
+        table.add_row(str(i), track.title, track.artist, track.album)
+
+    console.print(table)
+
+
+# -- Notes commands -------------------------------------------------------------
+
+
+@notes.command("list")
+@with_light
+@click.option(
+    "--id",
+    "-i",
+    "show_id",
+    default=False,
+    type=bool,
+    is_flag=True,
+    help="Include note ID in output (use with `notes watch`).",
+)
+@click.option(
+    "--content-preview",
+    "-c",
+    default=False,
+    type=bool,
+    is_flag=True,
+    help="Include content preview in output.",
+)
+def notes_list(light: Light, show_id=False, content_preview=False):
+    """List all notes on your device.
+
+    Shows the first line of text notes and labels audio notes.
+    """
+    all_notes = light.notes.get_notes()
+
+    if content_preview:
+        console.print(f"[dim]Content preview enabled. This might take a while.[/dim]")
+
+    for i, note in enumerate(all_notes, 1):
+        if content_preview:
+            content = light.notes.get_note_content(note)
+        else:
+            content = ""
+
+        if note.note_type == "audio":
+            preview = f"[dim](audio)[/dim] {note.title}"
+        elif content and content.strip():
+            preview = f"[dim]({note.title})[/dim] {content.splitlines()[0]}"
+        else:
+            preview = "[dim](empty)[/dim]"
+
+        id_prefix = f"{note.id} " if show_id else ""
+        console.print(f"[dim]{i}.[/dim] {id_prefix}{preview}")
+
+
+@notes.command("download")
+@with_light
+@click.argument("path")
+def notes_download(light: Light, path: str):
+    """Download all notes to a directory.
+
+    Text notes are saved as `.txt`, audio notes as `.m4a`.
+    If two notes share a title, the timestamp is appended to disambiguate.
+
+    **Example:**
+
+    `light notes download ~/my-notes`
+    """
+    light.notes.download_notes(path)
+
+
+@notes.command("add")
+@with_light
+@click.argument("title")
+@click.argument("content", default=None, required=False)
+@click.option(
+    "--file",
+    "-f",
+    "content_file",
+    default=None,
+    type=click.Path(exists=True),
+    help="Read note content from a file instead of inline.",
+)
+def notes_add(light: Light, title: str, content: str | None, content_file: str | None):
+    """Create a new text note.
+
+    Provide content inline as an argument, or from a file with `--file`.
+
+    **Examples:**
+
+    `light notes add "Shopping list" "eggs, milk, bread"`
+
+    `light notes add "Meeting notes" --file notes.txt`
+    """
+    if content is None and content_file is None:
+        raise click.UsageError("Provide CONTENT or --file.")
+
+    if content is not None and content_file is not None:
+        raise click.UsageError("CONTENT and --file are mutually exclusive.")
+
+    if content_file:
+        light.notes.create_text_note(title, content_file, content_is_path=True)
+    else:
+        light.notes.create_text_note(title, content)
+
+
+@notes.command("watch")
+@with_light
+@click.argument("note_id")
+def notes_watch(light: Light, note_id: str):
+    """Poll a note for changes and print its content when updated.
+
+    Checks every 5 seconds and prints content when `updated_at` changes.
+    Useful for watching a note you're actively editing on your phone.
+
+    Run `light notes list --id` to find the note ID.
+
+    **Example:**
+
+    `light notes watch 4f1d3063-085b-4738-8ba1-582c5d1cd9ac`
+    """
+    note = light.notes.get_note_metadata(note_id)
+    last_updated_at = note.updated_at
+
+    while True:
+        time.sleep(5)
+        note = light.notes.get_note_metadata(note_id)
+        if note.updated_at != last_updated_at:
+            content = light.notes.get_note_content(note)
+            console.print(f"[green]Updated at {note.updated_at}:[/green]")
+            console.print(content.decode())
+            last_updated_at = note.updated_at
+
+
+# -- Tools commands ------------------------------------------------------------
+
+
+@cli.group()
+def tools():
+    """Installed tools introspection."""
+    pass
+
+
+@tools.command("list")
+@with_light
+def tools_list(light: Light):
+    """List all tools installed on your device."""
+    all_tools = light.tools.get_tools()
+
+    table = Table(show_header=True)
+    table.add_column("Title")
+    table.add_column("Namespace")
+
+    for t in all_tools:
+        table.add_row(t.title, t.namespace)
+
+    console.print(table)
+
+
+@tools.command("add")
+@with_light
+@click.argument(
+    "name", type=click.Choice([t.value for t in ToolName], case_sensitive=False)
+)
+def tools_add(light: Light, name: str):
+    """Install a tool on your device."""
+    tool = light.tools.add_tool(name)
+    console.print(f"[green]Installed:[/green] {tool.title}")
+
+
+@tools.command("remove")
+@with_light
+@click.argument(
+    "name", type=click.Choice([t.value for t in ToolName], case_sensitive=False)
+)
+def tools_remove(light: Light, name: str):
+    """Uninstall a tool from your device."""
+    if not click.confirm(f"Remove {name}?"):
+        return
+    light.tools.remove_tool(name)
+    console.print("[green]Removed.[/green]")
+
+
+# -- TUI ------------------------------------------------------------------------
+
+
+@cli.command()
+@click.pass_context
+def tui(ctx):
+    """Launch the interactive terminal UI.
+
+    A full-screen interface for browsing and managing your music library
+    with vim-style keybindings.
+    """
+    obj = ctx.obj or {}
+    run_tui(
+        LightConfig(
+            email=obj.get("email"),
+            email_file=obj.get("email_file"),
+            password=obj.get("password"),
+            password_file=obj.get("password_file"),
+            phone=obj.get("phone_number"),
+            phone_file=obj.get("phone_number_file"),
+        )
+    )
+
+
+if __name__ == "__main__":
+    cli()