feat: enhance installation and task management with cross-platform support

- Refactored `install.sh` to streamline wizard invocation with dynamic arguments.
- Updated installation documentation to include Linux systemd service instructions.
- Enhanced task management CLI to support postponing alarms with user input for future tasks.
- Added cross-platform file opening functionality for generated reports and visualizations.
- Introduced default notification sounds based on the operating system.
- Improved internationalization for new task features and prompts.

Author: sergiudm

documentation/docs/cli/task-management.md

@@ -36,7 +36,7 @@ rmd add "Biology homework" 9 1 1
 ```
 
 ### Interactive Mode
-If you run `rmd add` directly without parameters in an interactive terminal, or if you omit some parameters, the system will display a friendly **Task Creator Wizard** panel, guiding you through a couple of quick questions one by one with emojis to complete the task description, priority level, and task type.
+If you run `rmd add` directly without parameters in an interactive terminal, or if you omit some parameters, the system will display a friendly **Task Creator Wizard** panel, guiding you through a couple of quick questions one by one with emojis to complete the task description, priority level, task type, and the optional **postpone days** (to make it a future task whose daily urgent alarm starts later). Press Enter at the postpone prompt to skip it and start the alarm today.
 
 If you are running in a non-interactive environment (such as a script), omitting the required parameters will print an error message and exit with an error code. Any omitted optional parameters (like task type) will fall back to their default values (e.g. task type 1).
 

documentation/docs/installation.md

@@ -48,10 +48,18 @@ It installs `rmd` as the primary CLI and keeps `reminder` as a compatibility ali
     *   Register the background service (on macOS and Linux).
 
 2.  **Finalize Setup**:
-    Follow the on-screen instructions to load the service. Typically, this involves:
-    ```bash
-    launchctl load ~/Library/LaunchAgents/com.sergiudm.schedule.management.reminder.plist
-    ```
+    Follow the on-screen instructions to start the background service.
+    -   **macOS** (launchd):
+        ```bash
+        launchctl load ~/Library/LaunchAgents/com.sergiudm.schedule.management.reminder.plist
+        ```
+    -   **Linux** (systemd user service):
+        ```bash
+        systemctl --user start schedule-management.service
+        systemctl --user enable schedule-management.service  # auto-start at login
+        ```
+        > Make sure lingering is enabled so the user service runs without an
+        > active login session: `loginctl enable-linger "$USER"`.
 
 ### Method 2: Manual Installation
 
@@ -148,11 +156,17 @@ Confirm that everything is working correctly.
     ```
     *Expected output: A list of available commands.*
 
-2.  **Check Service Status** (macOS):
-    ```bash
-    launchctl list | grep schedule
-    ```
-    *Expected output: A process ID and status code (usually 0).*
+2.  **Check Service Status**:
+    -   **macOS**:
+        ```bash
+        launchctl list | grep schedule
+        ```
+        *Expected output: A process ID and status code (usually 0).*
+    -   **Linux**:
+        ```bash
+        systemctl --user status schedule-management.service
+        ```
+        *Expected output: `active (running)` with recent log lines.*
 
 3.  **View Schedule**:
     ```bash
@@ -165,9 +179,15 @@ Confirm that everything is working correctly.
 To completely remove the application:
 
 1.  **Unload the Service**:
-    ```bash
-    launchctl unload ~/Library/LaunchAgents/com.sergiudm.schedule.management.reminder.plist
-    ```
+    -   **macOS**:
+        ```bash
+        launchctl unload ~/Library/LaunchAgents/com.sergiudm.schedule.management.reminder.plist
+        ```
+    -   **Linux**:
+        ```bash
+        systemctl --user stop schedule-management.service
+        systemctl --user disable schedule-management.service
+        ```
 
 2.  **Remove Configuration & Data**:
     ```bash

documentation/docs/intro.md

@@ -61,7 +61,7 @@ Selected sources:
     *   **Time Points**: Instant, one-off reminders (e.g., "Hydrate", "Bedtime").
     *   **Common Routines**: Define daily habits once, apply them everywhere.
 *   **CLI Power**: A comprehensive command-line interface for managing tasks, visualizing schedules, and controlling the daemon.
-*   **System Integration**: Runs as a native background service (via `launchd` on macOS), ensuring reliability across reboots.
+*   **System Integration**: Runs as a native background service (via `launchd` on macOS or a `systemd` user service on Linux), ensuring reliability across reboots.
 
 ## Why TOML?
 

install.sh

@@ -400,17 +400,20 @@ configure_configs() {
         extra_args+=("--yes")
     fi
 
+    local wizard_invocation=(
+        "$INSTALL_DIR/.venv/bin/python" "$wizard_script"
+        --config-dir "$target_config_dir"
+    )
     if [[ -d "$template_dir" ]]; then
-        "$INSTALL_DIR/.venv/bin/python" "$wizard_script" \
-            --config-dir "$target_config_dir" \
-            --template-dir "$template_dir" \
-            "${extra_args[@]:-}"
+        wizard_invocation+=(--template-dir "$template_dir")
     else
         log_warning "Template directory not found at $template_dir; using config directory as template source."
-        "$INSTALL_DIR/.venv/bin/python" "$wizard_script" \
-            --config-dir "$target_config_dir" \
-            "${extra_args[@]:-}"
     fi
+    if [[ ${#extra_args[@]} -gt 0 ]]; then
+        wizard_invocation+=("${extra_args[@]}")
+    fi
+
+    "${wizard_invocation[@]}"
 
     log_info "Validated active config directory: $target_config_dir"
     log_success "Configuration checks complete"

src/schedule_management/commands/service.py

@@ -31,6 +31,7 @@
     HABIT_PATH,
 )
 from schedule_management.i18n import _t
+from schedule_management.platform import open_file
 from schedule_management.config_layout import (
     list_config_ids,
     preview_active_config_dir,
@@ -398,12 +399,9 @@ def report_command(args) -> int:
         if report_path:
             print("\n" + _t("✅ Report generated: {path}").format(path=report_path))
 
-            # Try to open on macOS
-            if sys.platform == "darwin":
-                try:
-                    subprocess.run(["open", str(report_path)], check=False)
-                except Exception:
-                    pass  # Silent fail for opening
+            # Try to open the generated report in the default viewer (cross-platform)
+            if not open_file(report_path):
+                pass  # No opener available; the report path was already printed above
 
             return 0
         else:

src/schedule_management/commands/status.py

@@ -14,7 +14,6 @@
     $ rmd view            # Generate schedule PDF
 """
 
-import subprocess
 import sys
 from datetime import date, datetime, timedelta
 from pathlib import Path
@@ -32,6 +31,7 @@
 
 from schedule_management import SETTINGS_PATH, ODD_PATH, EVEN_PATH
 from schedule_management.i18n import _t
+from schedule_management.platform import open_file
 from schedule_management.config import ScheduleConfig, WeeklySchedule
 from schedule_management.synced_schedule import (
     apply_synced_schedule,
@@ -410,24 +410,14 @@ def view_command(args) -> int:
 
         print("\n" + _t("📁 Visualization file generated:"))
 
-        # Open PDF on macOS
-        if sys.platform == "darwin":
-            print("\n" + _t("🖼️  Opening visualization..."))
-            try:
-                import platform
-
-                if platform.system() == "Windows":
-                    desktop_path = Path.home() / "Desktop"
-                else:
-                    desktop_path = Path.home() / "Desktop"
-
-                pdf_path = desktop_path / "schedule_visualization.pdf"
-                subprocess.run(
-                    ["open", str(pdf_path)],
-                    check=False,
-                )
-            except Exception as e:
-                print(_t("⚠️  Could not open file: {e}").format(e=e))
+        # Open the generated PDF in the default viewer (cross-platform)
+        print("\n" + _t("🖼️  Opening visualization..."))
+        try:
+            pdf_path = Path.home() / "Desktop" / "schedule_visualization.pdf"
+            if not open_file(pdf_path):
+                print(_t("⚠️  Could not open file automatically. File saved to: {path}").format(path=pdf_path))
+        except Exception as e:
+            print(_t("⚠️  Could not open file: {e}").format(e=e))
 
         return 0
 

src/schedule_management/commands/tasks.py

@@ -177,6 +177,42 @@ def add_task(args) -> int:
                     else:
                         console.print("[bold yellow]" + _t("⚠️  Oops! Invalid selection. Please choose a valid number from the list.") + "[/bold yellow]")
 
+            # Optional: postpone the daily urgent alarm to make this a future task.
+            if postpone is None:
+                console.print(
+                    "\n[bold cyan]"
+                    + _t("🗓️  Postpone the daily urgent alarm? Enter days from now (0 or empty = start today): ")
+                    + "[/bold cyan]"
+                )
+                while True:
+                    try:
+                        postpone_input = console.input(
+                            "[bold cyan]" + _t("Postpone days (default 0): ") + "[/bold cyan]"
+                        ).strip()
+                    except (EOFError, KeyboardInterrupt):
+                        print("\n" + _t("👋 Operation cancelled. Have a great day! ✨"))
+                        return 1
+                    if postpone_input == "":
+                        postpone = 0
+                        break
+                    try:
+                        postpone_val = int(postpone_input)
+                        if postpone_val < 0:
+                            console.print(
+                                "[bold yellow]"
+                                + _t("⚠️  Oops! Postpone days must be a non-negative integer. Let's try that again! 🌟")
+                                + "[/bold yellow]"
+                            )
+                            continue
+                        postpone = postpone_val
+                        break
+                    except ValueError:
+                        console.print(
+                            "[bold yellow]"
+                            + _t("⚠️  Oops! Postpone days needs to be a valid number. Please enter a non-negative integer! 🔢")
+                            + "[/bold yellow]"
+                        )
+
     # Validate priority
     if priority <= 0:
         print(_t("❌ Error: Priority must be a positive integer"))

src/schedule_management/config.py

@@ -28,6 +28,23 @@
 import tomllib
 
 
+# Default notification sounds per platform. These are only used when a config
+# does not set ``sound_file`` explicitly; if the file is absent at runtime the
+# alarm still fires (the dialog appears, the sound is simply skipped).
+_DEFAULT_SOUND_MACOS = "/System/Library/Sounds/Ping.aiff"
+# Ships with sound-theme-freedesktop on most GNOME/Ubuntu/Fedora installs.
+_DEFAULT_SOUND_LINUX = "/usr/share/sounds/freedesktop/stereo/complete.oga"
+
+
+def _default_sound_file() -> str:
+    """Return the platform-appropriate default notification sound path."""
+    from schedule_management.platform import get_platform
+
+    if get_platform() == "macos":
+        return _DEFAULT_SOUND_MACOS
+    return _DEFAULT_SOUND_LINUX
+
+
 # =============================================================================
 # TOML FILE LOADING
 # =============================================================================
@@ -106,10 +123,13 @@ def sound_file(self) -> str:
         """
         Path to the notification sound file.
 
-        Returns:
-            Sound file path (default: macOS Ping sound)
+        Returns the configured ``sound_file`` if set; otherwise falls back to a
+        platform-appropriate system sound (macOS ``Ping.aiff`` or the
+        freedesktop ``complete.oga`` on Linux). On platforms where the default
+        file is missing, ``play_sound`` degrades gracefully to no audio while
+        the alarm dialog still appears.
         """
-        return self.settings.get("sound_file", "/System/Library/Sounds/Ping.aiff")
+        return self.settings.get("sound_file", _default_sound_file())
 
     @property
     def alarm_interval(self) -> int:

src/schedule_management/i18n.py

@@ -76,6 +76,10 @@ def get_language() -> str:
     "Enter Task Type Number: ": "请输入任务类型编号：",
     "⚠️  Oops! Invalid selection. Please choose a valid number from the list.": "⚠️ 哎呀！选择无效。请从列表中选择一个有效的编号。",
     "❌ Error: Invalid task type. Choose from: {choices}": "❌ 错误：无效的任务类型。可选范围：{choices}",
+    "🗓️  Postpone the daily urgent alarm? Enter days from now (0 or empty = start today): ": "🗓️ 要推迟每日紧急提醒吗？请输入从今天起的天数（0 或留空 = 今天开始）：",
+    "Postpone days (default 0): ": "推迟天数（默认 0）：",
+    "⚠️  Oops! Postpone days must be a non-negative integer. Let's try that again! 🌟": "⚠️ 哎呀！推迟天数必须是非负整数。让我们再试一次！🌟",
+    "⚠️  Oops! Postpone days needs to be a valid number. Please enter a non-negative integer! 🔢": "⚠️ 哎呀！推迟天数必须是一个有效的数字。请输入非负整数！🔢",
     "Legend:": "图例：",
     "👋 Operation cancelled. Have a great day! ✨": "👋 操作已取消。祝您度过美好的一天！✨",
     "❌ Error: Priority must be a positive integer": "❌ 错误：优先级必须是正整数",

src/schedule_management/platform.py

@@ -19,8 +19,10 @@
     >>> show_dialog('Reminder: Time for a break!')
 """
 
+import shutil
 import subprocess
 import sys
+from pathlib import Path
 
 
 # =============================================================================
@@ -52,6 +54,43 @@ def get_platform() -> str:
         return "unknown"
 
 
+def open_file(path: str | Path) -> bool:
+    """
+    Open a file or directory using the platform's default application.
+
+    Picks the native "open" command for the current platform and falls back
+    silently if no suitable opener is found.
+
+    Args:
+        path: File or directory path to open.
+
+    Returns:
+        True if an opener command was available and launched, False otherwise.
+        Note: a True result does not guarantee the application actually opened
+        the file; the opener process is spawned non-blocking.
+
+    Example:
+        >>> open_file('/path/to/report.pdf')
+    """
+    platform_name = get_platform()
+    if platform_name == "macos":
+        openers = ["open"]
+    elif platform_name == "linux":
+        openers = ["xdg-open"]
+    else:
+        openers = ["xdg-open", "open"]
+
+    for opener in openers:
+        if shutil.which(opener) is None:
+            continue
+        try:
+            subprocess.Popen([opener, str(path)])
+            return True
+        except (FileNotFoundError, OSError):
+            continue
+    return False
+
+
 # =============================================================================
 # SOUND PLAYBACK
 # =============================================================================