@barrysongdev4real/listenup-cli 0.1.0

package/LICENSE

@@ -0,0 +1,145 @@
+PolyForm Noncommercial License 1.0.0
+
+https://polyformproject.org/licenses/noncommercial/1.0.0
+
+Acceptance
+
+In order to get any license under these terms, you must agree to them as
+both strict obligations and conditions to all your licenses.
+
+Copyright License
+
+The licensor grants you a copyright license for the software to do everything
+you might do with the software that would otherwise infringe the licensor's
+copyright in it for any permitted purpose. However, you may only distribute
+the software according to Distribution License and make changes or new works
+based on the software according to Changes and New Works License.
+
+Distribution License
+
+The licensor grants you an additional copyright license to distribute copies
+of the software. Your license to distribute covers distributing the software
+with changes and new works permitted by Changes and New Works License.
+
+Notices
+
+You must ensure that anyone who gets a copy of any part of the software from
+you also gets a copy of these terms or the URL for them above, as well as
+copies of any plain-text lines beginning with `Required Notice:` that the
+licensor provided with the software. For example:
+
+Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and
+new works based on the software for any permitted purpose.
+
+Patent License
+
+The licensor grants you a patent license for the software that covers patent
+claims the licensor can license, or becomes able to license, that you would
+infringe by using the software.
+
+Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public
+knowledge, personal study, private entertainment, hobby projects, amateur
+pursuits, or religious observance, without any anticipated commercial
+application, is use for a permitted purpose.
+
+Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research
+organization, public safety or health organization, environmental protection
+organization, or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting from the funding.
+
+Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do
+not limit them.
+
+No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to
+anyone else, or prevent the licensor from granting licenses to anyone else.
+These terms do not imply any other licenses.
+
+Patent Defense
+
+If you make any written claim that the software infringes or contributes to
+infringement of any patent, your patent license for the software granted under
+these terms ends immediately. If your company makes such a claim, your patent
+license ends immediately for work on behalf of your company.
+
+Violations
+
+The first time you are notified in writing that you have violated any of these
+terms, or done anything with the software not covered by your licenses, your
+licenses can nonetheless continue if you come into full compliance with these
+terms, and take practical steps to correct past violations, within 32 days of
+receiving notice. Otherwise, all your licenses end immediately.
+
+No Liability
+
+As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.
+
+Definitions
+
+The licensor is the individual or entity offering these terms, and the
+software is the software the licensor makes available under these terms.
+
+You refers to the individual or entity agreeing to these terms.
+
+Your company is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+Control means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+Your licenses are all the licenses granted to you for the software under these
+terms.
+
+Use means anything you do with the software requiring one of your licenses.
+
+Copyright PolyForm Project Inc.
+
+Required Notice: Copyright (c) 2026 ListenUp Extension contributors.
+Required Notice: ListenUp Extension is licensed for noncommercial use under
+PolyForm Noncommercial License 1.0.0.
+
+Third-Party / Template Notice
+
+This project includes portions derived from vite-web-extension, originally
+licensed under the MIT License:
+
+The MIT License (MIT)
+
+Copyright (c) 2022 Jonathan Braat
+
+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.

package/README.md

@@ -0,0 +1,32 @@
+# ListenUp CLI
+
+安全读取 ListenUp Desktop 保存在本机 SQLite 中的 YouTube 原字幕，并校验、导入由用户自己的
+AI 生成的完整译文。CLI 不包含翻译模型、不上传字幕，也不开放任意 SQL。
+
+## 安装
+
+首个版本仅支持 macOS Apple Silicon，需要 Node.js 20 或更高版本：
+
+```bash
+npm install -g @barrysongdev4real/listenup-cli@0.1.0
+listenup --version
+```
+
+## 常用命令
+
+```bash
+listenup info --json
+listenup video list --json
+listenup subtitle get VIDEO_ID --json
+listenup translation list VIDEO_ID --json
+listenup translation get VIDEO_ID --language ja --json
+listenup translation apply translation.json --dry-run --json
+listenup translation apply translation.json --commit --json
+```
+
+写操作默认只是 dry-run，只有显式传入 `--commit` 才会修改数据库。默认访问正式版 Desktop
+数据库；本地开发可传 `--env dev`，测试可以传 `--db /absolute/path/to/test.sqlite`。
+
+完整的 AI 工作流见不可变版本中的
+[`listenup-local-translator`](https://github.com/BarrySong97/listenup-extension/tree/cli-v0.1.0/skills/listenup-local-translator)
+Skill。

package/bin/listenup.mjs

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+/**
+ * @purpose 启动 npm 包内固定的 macOS arm64 listenup Rust 二进制。
+ * @role    npm `listenup` bin 的薄平台校验与进程转发层。
+ * @deps    node:child_process、node:url、vendor/darwin-arm64/listenup
+ * @gotcha  不读取数据库或改写 JSON；参数、stdio、signal 和退出状态必须原样转发。
+ */
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+if (process.platform !== "darwin" || process.arch !== "arm64") {
+  console.error(
+    `listenup 0.1.x supports macOS Apple Silicon only; detected ${process.platform}-${process.arch}.`
+  );
+  process.exit(1);
+}
+
+const binary = fileURLToPath(
+  new URL("../vendor/darwin-arm64/listenup", import.meta.url)
+);
+const child = spawn(binary, process.argv.slice(2), { stdio: "inherit" });
+const forwardedSignals = ["SIGINT", "SIGTERM", "SIGHUP"];
+
+for (const signal of forwardedSignals) {
+  process.on(signal, () => {
+    if (!child.killed) child.kill(signal);
+  });
+}
+
+child.once("error", (error) => {
+  console.error(`listenup failed to start: ${error.message}`);
+  process.exitCode = 1;
+});
+
+child.once("exit", (code, signal) => {
+  if (signal) {
+    for (const forwardedSignal of forwardedSignals) {
+      process.removeAllListeners(forwardedSignal);
+    }
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exitCode = code ?? 1;
+});

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@barrysongdev4real/listenup-cli",
+  "version": "0.1.0",
+  "description": "Safe local CLI for reading ListenUp subtitles and importing AI translations.",
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "type": "module",
+  "bin": {
+    "listenup": "./bin/listenup.mjs"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64"
+  ]
+}