icloud-cli-tools 0.1.0__tar.gz

icloud_cli_tools-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint with ruff
+        run: ruff check src/ tests/
+
+      - name: Run tests
+        run: pytest tests/ -v --tb=short

icloud_cli_tools-0.1.0/.gitignore

@@ -0,0 +1,34 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.ruff_cache/
+
+# icloud-cli session data 
+session/

icloud_cli_tools-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alan Beltran Pozo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

icloud_cli_tools-0.1.0/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: icloud-cli-tools
+Version: 0.1.0
+Summary: Access iCloud Calendar, Reminders, Notes, and Find My from Linux
+Author: alan
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/alan13367/icloud-cli-tools
+Project-URL: Repository, https://github.com/alan13367/icloud-cli-tools
+Project-URL: Issues, https://github.com/alan13367/icloud-cli-tools/issues
+Keywords: icloud,apple,calendar,reminders,notes,findmy,cli,linux
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyicloud>=1.0.0
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Requires-Dist: keyring>=25.0
+Requires-Dist: toml>=0.10
+Requires-Dist: python-dateutil>=2.8
+Requires-Dist: html2text>=2024.2
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Dynamic: license-file
+
+# ☁️ icloud-cli-tools
+
+> Access your iCloud **Calendar**, **Reminders**, **Notes**, and **Find My** devices from the Linux terminal.
+
+[![CI](https://github.com/alan/icloud-cli-tools/actions/workflows/ci.yml/badge.svg)](https://github.com/alan/icloud-cli-tools/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-green.svg)](https://python.org)
+
+## Features
+
+- 📅 **Calendar** — List, create, and delete events with natural date parsing
+- ✅ **Reminders** — Manage reminders across lists, mark complete, set priorities
+- 📝 **Notes** — Read, create, and search your iCloud Notes
+- 📍 **Find My** — Locate devices, play sounds, activate Lost Mode
+- 🔄 **Background Sync** — Daemon with systemd integration for periodic caching
+- 🔐 **Secure Auth** — 2FA support, OS keyring for credentials, session caching
+- 🎨 **Beautiful Output** — Rich tables, JSON, and plain text formats
+
+## Installation
+
+```bash
+# Clone the repo
+git clone https://github.com/alan13367/icloud-cli-tools.git
+cd icloud-cli-tools
+
+# Set up a virtual environment (recommended, required on modern Debian/Ubuntu)
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+> **Tip:** To use `icloud-cli` without activating the venv every time, add an alias:
+> ```bash
+> echo 'alias icloud-cli="~/icloud-cli-tools/.venv/bin/icloud-cli"' >> ~/.bashrc
+> source ~/.bashrc
+> ```
+
+## Quick Start
+
+```bash
+# 1. Login to your iCloud account
+icloud-cli login
+
+# 2. Set up Notes access (requires app-specific password)
+icloud-cli notes setup-imap
+
+# 3. Start using it!
+icloud-cli calendar list
+icloud-cli reminders list
+icloud-cli notes list
+icloud-cli findmy list
+```
+
+## Usage
+
+### Authentication
+
+```bash
+icloud-cli login          # Interactive login with 2FA
+icloud-cli logout         # Clear all stored credentials
+icloud-cli status         # Check auth status
+```
+
+### Calendar
+
+```bash
+icloud-cli calendar list                    # Events for next 7 days
+icloud-cli calendar list --from today --to tomorrow
+icloud-cli calendar show <event-id>
+icloud-cli calendar add -t "Meeting" -s "2025-06-15 10:00" -e "2025-06-15 11:00"
+icloud-cli calendar delete <event-id>
+```
+
+### Reminders
+
+```bash
+icloud-cli reminders list                   # All active reminders
+icloud-cli reminders list --list "Shopping" --completed
+icloud-cli reminders add -t "Buy milk" -d "2025-06-15" -l "Shopping"
+icloud-cli reminders complete <reminder-id>
+icloud-cli reminders delete <reminder-id>
+```
+
+### Notes
+
+```bash
+icloud-cli notes list
+icloud-cli notes show <note-id>
+icloud-cli notes add -t "My Note" -b "Note content here"
+icloud-cli notes search "keyword"
+```
+
+> **Note:** Notes access requires an app-specific password. Generate one at
+> [appleid.apple.com](https://appleid.apple.com/account/manage) →
+> *Sign In & Security* → *App-Specific Passwords*.
+
+### Find My
+
+```bash
+icloud-cli findmy list                      # All devices with status
+icloud-cli findmy locate "iPhone"           # GPS coordinates + Maps link
+icloud-cli findmy play-sound "iPhone"       # Ring your device
+icloud-cli findmy lost-mode "iPhone" -p "+1234567890" -m "Please return"
+```
+
+### Sync & Daemon
+
+```bash
+icloud-cli sync                # One-shot sync to local cache
+icloud-cli daemon start        # Start background sync (every 15 min)
+icloud-cli daemon stop         # Stop daemon
+icloud-cli daemon status       # Check daemon status
+```
+
+#### Systemd Integration (Linux)
+
+```bash
+# Install the service
+cp systemd/icloud-cli-sync.service ~/.config/systemd/user/
+systemctl --user enable icloud-cli-sync
+systemctl --user start icloud-cli-sync
+```
+
+### Output Formats
+
+```bash
+icloud-cli calendar list -f table   # Rich formatted table (default)
+icloud-cli calendar list -f json    # Machine-readable JSON
+icloud-cli calendar list -f plain   # Tab-separated for scripting
+```
+
+## Configuration
+
+Config file: `~/.config/icloud-cli/config.toml`
+
+```toml
+[general]
+default_format = "table"
+verbose = false
+
+[auth]
+apple_id = "your@icloud.com"
+
+[sync]
+sync_interval_minutes = 15
+
+[calendar]
+default_calendar = "Personal"
+
+[reminders]
+default_reminder_list = "Reminders"
+```
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/ -v
+
+# Lint
+ruff check src/ tests/
+```
+
+## ⚠️ Disclaimer
+
+This project uses **unofficial/private iCloud web APIs** via the
+[pyicloud](https://github.com/picklepete/pyicloud) library. Apple may change
+these APIs at any time without notice, which could break functionality. This
+tool is not affiliated with or endorsed by Apple Inc.
+
+## License
+
+[MIT](LICENSE)

icloud_cli_tools-0.1.0/README.md

@@ -0,0 +1,176 @@
+# ☁️ icloud-cli-tools
+
+> Access your iCloud **Calendar**, **Reminders**, **Notes**, and **Find My** devices from the Linux terminal.
+
+[![CI](https://github.com/alan/icloud-cli-tools/actions/workflows/ci.yml/badge.svg)](https://github.com/alan/icloud-cli-tools/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-green.svg)](https://python.org)
+
+## Features
+
+- 📅 **Calendar** — List, create, and delete events with natural date parsing
+- ✅ **Reminders** — Manage reminders across lists, mark complete, set priorities
+- 📝 **Notes** — Read, create, and search your iCloud Notes
+- 📍 **Find My** — Locate devices, play sounds, activate Lost Mode
+- 🔄 **Background Sync** — Daemon with systemd integration for periodic caching
+- 🔐 **Secure Auth** — 2FA support, OS keyring for credentials, session caching
+- 🎨 **Beautiful Output** — Rich tables, JSON, and plain text formats
+
+## Installation
+
+```bash
+# Clone the repo
+git clone https://github.com/alan13367/icloud-cli-tools.git
+cd icloud-cli-tools
+
+# Set up a virtual environment (recommended, required on modern Debian/Ubuntu)
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+> **Tip:** To use `icloud-cli` without activating the venv every time, add an alias:
+> ```bash
+> echo 'alias icloud-cli="~/icloud-cli-tools/.venv/bin/icloud-cli"' >> ~/.bashrc
+> source ~/.bashrc
+> ```
+
+## Quick Start
+
+```bash
+# 1. Login to your iCloud account
+icloud-cli login
+
+# 2. Set up Notes access (requires app-specific password)
+icloud-cli notes setup-imap
+
+# 3. Start using it!
+icloud-cli calendar list
+icloud-cli reminders list
+icloud-cli notes list
+icloud-cli findmy list
+```
+
+## Usage
+
+### Authentication
+
+```bash
+icloud-cli login          # Interactive login with 2FA
+icloud-cli logout         # Clear all stored credentials
+icloud-cli status         # Check auth status
+```
+
+### Calendar
+
+```bash
+icloud-cli calendar list                    # Events for next 7 days
+icloud-cli calendar list --from today --to tomorrow
+icloud-cli calendar show <event-id>
+icloud-cli calendar add -t "Meeting" -s "2025-06-15 10:00" -e "2025-06-15 11:00"
+icloud-cli calendar delete <event-id>
+```
+
+### Reminders
+
+```bash
+icloud-cli reminders list                   # All active reminders
+icloud-cli reminders list --list "Shopping" --completed
+icloud-cli reminders add -t "Buy milk" -d "2025-06-15" -l "Shopping"
+icloud-cli reminders complete <reminder-id>
+icloud-cli reminders delete <reminder-id>
+```
+
+### Notes
+
+```bash
+icloud-cli notes list
+icloud-cli notes show <note-id>
+icloud-cli notes add -t "My Note" -b "Note content here"
+icloud-cli notes search "keyword"
+```
+
+> **Note:** Notes access requires an app-specific password. Generate one at
+> [appleid.apple.com](https://appleid.apple.com/account/manage) →
+> *Sign In & Security* → *App-Specific Passwords*.
+
+### Find My
+
+```bash
+icloud-cli findmy list                      # All devices with status
+icloud-cli findmy locate "iPhone"           # GPS coordinates + Maps link
+icloud-cli findmy play-sound "iPhone"       # Ring your device
+icloud-cli findmy lost-mode "iPhone" -p "+1234567890" -m "Please return"
+```
+
+### Sync & Daemon
+
+```bash
+icloud-cli sync                # One-shot sync to local cache
+icloud-cli daemon start        # Start background sync (every 15 min)
+icloud-cli daemon stop         # Stop daemon
+icloud-cli daemon status       # Check daemon status
+```
+
+#### Systemd Integration (Linux)
+
+```bash
+# Install the service
+cp systemd/icloud-cli-sync.service ~/.config/systemd/user/
+systemctl --user enable icloud-cli-sync
+systemctl --user start icloud-cli-sync
+```
+
+### Output Formats
+
+```bash
+icloud-cli calendar list -f table   # Rich formatted table (default)
+icloud-cli calendar list -f json    # Machine-readable JSON
+icloud-cli calendar list -f plain   # Tab-separated for scripting
+```
+
+## Configuration
+
+Config file: `~/.config/icloud-cli/config.toml`
+
+```toml
+[general]
+default_format = "table"
+verbose = false
+
+[auth]
+apple_id = "your@icloud.com"
+
+[sync]
+sync_interval_minutes = 15
+
+[calendar]
+default_calendar = "Personal"
+
+[reminders]
+default_reminder_list = "Reminders"
+```
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/ -v
+
+# Lint
+ruff check src/ tests/
+```
+
+## ⚠️ Disclaimer
+
+This project uses **unofficial/private iCloud web APIs** via the
+[pyicloud](https://github.com/picklepete/pyicloud) library. Apple may change
+these APIs at any time without notice, which could break functionality. This
+tool is not affiliated with or endorsed by Apple Inc.
+
+## License
+
+[MIT](LICENSE)

icloud_cli_tools-0.1.0/pyproject.toml

@@ -0,0 +1,68 @@
+[build-system]
+requires = ["setuptools>=68.0", "setuptools-scm>=8.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "icloud-cli-tools"
+version = "0.1.0"
+description = "Access iCloud Calendar, Reminders, Notes, and Find My from Linux"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [{ name = "alan" }]
+keywords = [
+    "icloud",
+    "apple",
+    "calendar",
+    "reminders",
+    "notes",
+    "findmy",
+    "cli",
+    "linux",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "pyicloud>=1.0.0",
+    "click>=8.1",
+    "rich>=13.0",
+    "keyring>=25.0",
+    "toml>=0.10",
+    "python-dateutil>=2.8",
+    "html2text>=2024.2",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "pytest-cov>=5.0", "ruff>=0.5"]
+
+[project.scripts]
+icloud-cli = "icloud_cli.main:cli"
+
+[project.urls]
+Homepage = "https://github.com/alan13367/icloud-cli-tools"
+Repository = "https://github.com/alan13367/icloud-cli-tools"
+Issues = "https://github.com/alan13367/icloud-cli-tools/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "N", "UP", "B", "SIM"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

icloud_cli_tools-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

icloud_cli_tools-0.1.0/src/icloud_cli/__init__.py

@@ -0,0 +1,3 @@
+"""icloud-cli-tools: Access iCloud services from Linux."""
+
+__version__ = "0.1.0"