autostartd 0.1.4

Cross-platform autostart manager for Windows Task Scheduler and Linux Supervisor

autostartd

自动启动管理工具，支持 Windows 任务计划程序与 Linux Supervisor。提供统一的交互式菜单，帮助你配置脚本或可执行文件自启动。

安装

pip install autostartd

如需 pyre_tools 菜单能力，再额外安装：

pip install "autostartd[tools]"

运行

autostartd

任何输入处输入 q 可退出当前流程返回菜单。

功能

• Windows：通过 schtasks 创建、更新、查询、删除任务。
• Windows 支持 .exe、.py、.bat、.cmd、.ps1。
• Windows 可选择登录后自启或登录前自启。
• Linux：通过 Supervisor 创建、查询、删除项目。
• Linux 支持 .py、.sh、.bash、.run、可执行文件、alias、原始命令、roslaunch、pip 工具命令和 python -m 模块命令。
• Linux 可选择登录前自启或登录后自启。
• Linux 创建时可选择“立即生效”或“仅下次开机/登录后生效”。
• Linux 会在首次 sudo 成功后缓存密码到 ~/.autostartd/config.json，后续复用；若失效会提示重新输入并更新缓存。
• Linux 提供基础管理菜单，可查看项目状态并启动、停止、重启、禁用自启、恢复自启。
• 支持中英文界面切换，语言配置保存到 ~/.autostartd/config.json。

自启动时机

Windows

• 登录后自启：创建 ONLOGON 任务，使用当前用户运行，通常不需要管理员权限。
• 登录前自启：创建 ONSTART 任务，使用 SYSTEM 账户和最高权限运行，需要在管理员终端运行。

Linux

• 登录前自启：使用系统级 Supervisor，配置写入 /etc/supervisor/conf.d/，需要 sudo。Supervisor 服务会尽量通过 systemctl enable --now supervisor 启用。
• 登录后自启：使用用户级 supervisord，配置写入 ~/.config/autostartd/supervisor/，并在 ~/.profile 中添加启动用户 supervisord 的片段。具体进程仍由 Supervisor 管理。
• 新增/修改项目时，可选择立即启动，或者只保存配置让它在下次开机/登录后生效。

WSL 中推荐启用 systemd 后使用登录前自启；如果不启用 systemd，可以使用登录后自启，用户登录 shell 后会启动用户级 supervisord。

Linux 启动类型

新增 Linux Supervisor 项目时可以选择启动类型：

• 自动识别脚本/可执行文件：.py 会用当前 Python，.sh/.bash 会用 /bin/bash，.run 或无扩展名可执行文件会直接运行。
• Shell/alias/原始命令：自动包装为 bash -lc，并加载 ~/.bashrc、~/.bash_profile，适合 alias、自定义命令、带管道或环境变量的命令。
• ROS roslaunch：输入包名和 launch 文件，自动包装为 roslaunch package file.launch ...。
• ROS roslaunch 会通过 bash -lc 加载常见 ROS 环境，并以前台主进程方式运行，降低 Supervisor BACKOFF 概率。
• pip 工具：输入命令名和参数，例如 uvicorn app:app --host 0.0.0.0。
• Python 模块：自动包装为 python -m module ...。

API 调用

from autostartd import set_autostart, remove_autostart, list_autostart

# start_mode 可选：
#   "after_login"
#   "before_login"
set_autostart(
    "my_task",
    "~/Downloads/test_auto_start.py",
    overwrite=True,
    sudo_password="your_sudo_password",
    start_mode="before_login",
)

set_autostart(
    "ros_task",
    "my_robot bringup.launch",
    command_type="roslaunch",
    start_mode="before_login",
    sudo_password="your_sudo_password",
    run_immediately=False,
)

set_autostart(
    "alias_task",
    "my_alias --flag",
    command_type="alias",
    start_mode="after_login",
)

print(list_autostart("my", sudo_password="your_sudo_password", start_mode="before_login"))

remove_autostart("my_task", sudo_password="your_sudo_password", start_mode="before_login")

说明：

• Windows 不需要 sudo_password。
• Linux before_login 需要 sudo_password。
• 若之前已经通过交互模式缓存过 sudo 密码，API 也可以复用该缓存。
• Linux after_login 不需要 sudo，但需要当前用户登录后启动用户级 supervisord。

依赖

• Windows：系统自带 schtasks。
• Linux：需要 supervisord 与 supervisorctl。Ubuntu/Debian 会尝试通过 apt-get install supervisor 自动安装；CentOS/RHEL 会尝试使用 dnf 或 yum。
• 首次自动安装 Supervisor 时会显示 tqdm 进度条。
• pyre_tools 为可选依赖，仅在需要菜单中的 Run pyre_tools 功能时安装。
• Python：3.8+。

---

autostartd

Cross-platform autostart manager for Windows Task Scheduler and Linux Supervisor.

Features

• Windows task management via schtasks.
• Windows supports .exe, .py, .bat, .cmd, and .ps1.
• Windows supports after-login and before-login startup.
• Linux process management via Supervisor.
• Linux supports .py, .sh, .bash, .run, executable files, aliases, raw commands, roslaunch, pip tool commands, and python -m module commands.
• Linux supports before-login system Supervisor and after-login user supervisord.
• Linux can either apply a new task immediately or only on the next boot/login.
• Linux caches a validated sudo password in ~/.autostartd/config.json and asks again only if the saved credential fails.
• Linux includes a basic management menu to start, stop, restart, disable autostart, and re-enable autostart.

Startup Timing

• Windows after login: creates an ONLOGON task for the current user.
• Windows before login: creates an ONSTART task as SYSTEM; run autostartd from an administrator terminal.
• Linux before login: writes system Supervisor config under /etc/supervisor/conf.d/; sudo is required.
• Linux after login: writes user Supervisor config under ~/.config/autostartd/supervisor/ and starts user supervisord from ~/.profile.

API

from autostartd import set_autostart, remove_autostart, list_autostart

set_autostart("my_task", "/path/to/app.py", start_mode="before_login", sudo_password="password")
set_autostart("ros_task", "my_pkg bringup.launch", command_type="roslaunch", start_mode="before_login", sudo_password="password")
set_autostart("tool_task", "uvicorn app:app --host 0.0.0.0", command_type="pip", start_mode="after_login")
print(list_autostart("my", start_mode="before_login", sudo_password="password"))
remove_autostart("my_task", start_mode="before_login", sudo_password="password")

Installation Notes

pip install autostartd

Install the optional pyre_tools integration only if you need that menu action:

pip install "autostartd[tools]"