Skip to content

A lightweight 2.5D character player for the web, with lip sync and webcam face tracking.

Credits: Kujira, Kujira Q and Pen come from other people's work

LivLiv42d52b3843e2
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index e4ab84f..8d36261 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -15,4 +15,4 @@ npm run check && npm test && npm run build && npm run test:browser
Contributions are under the Apache License 2.0, like the rest of the code (section 5 of the licence).
-The featured characters in `characters/` are LivLiv's and take no changes; see their [licence](characters/LICENSE.md).
+The featured characters in `characters/` take no changes; see their [licence](characters/LICENSE.md) and [credits](characters/CREDITS.md).
diff --git a/NOTICE b/NOTICE
index fbbcd1f..b39127b 100644
--- a/NOTICE
+++ b/NOTICE
@@ -3,5 +3,5 @@ Copyright 2026 LivLiv
This product includes software developed by LivLiv (https://livliv.ai).
-The featured characters in characters/ are not licensed under the Apache License 2.0. Their own licence is
-characters/LICENSE.md.
+The featured characters in characters/ are not licensed under the Apache License 2.0. Their own terms are in
+characters/LICENSE.md and characters/CREDITS.md. Three of them (Kujira, Kujira Q, Pen) come from other people's work.
diff --git a/README.ja.md b/README.ja.md
index 8923b50..799527b 100644
--- a/README.ja.md
+++ b/README.ja.md
@@ -71,7 +71,9 @@ API の全体は [API.md](API.md)(英語)にあります:オプション
## 厳選キャラクター
-`characters/` には LivLiv が制作した 21 体のキャラクターが入っていて、そのまま `load()` できます。右下に小さな LivLiv のマークが入っていて、プレイヤーがそれを描きます。これらには Apache License は**適用されません**。個人の非商用利用は、クレジット(「キャラクター:LivLiv(livliv.ai)」)を入れれば無料です。販売、商用利用、AI モデルの学習には使えません。Nana は LivLiv のマスコットです。条文は [characters/LICENSE.md](characters/LICENSE.md) をご覧ください。
+`characters/` には 21 体のキャラクターが入っていて、そのまま `load()` できます。右下に小さな LivLiv のマークが入っていて、プレイヤーがそれを描きます。これらには Apache License は**適用されません**。大半は LivLiv が制作したもので、個人の非商用利用は、クレジット(「キャラクター:LivLiv(livliv.ai)」)を入れれば無料です。販売、商用利用、AI モデルの学習には使えません。Nana は LivLiv のマスコットです。条文は [characters/LICENSE.md](characters/LICENSE.md) をご覧ください。
+
+Kujira、Kujira Q、Pen は他の方の作品に基づくもので、上記のライセンスとクレジットは適用されません。出典、クレジット、条件は [characters/CREDITS.md](characters/CREDITS.md) をご覧ください。
キャラクターの一覧は[英語の README](README.md#featured-characters) にあります。
@@ -89,7 +91,7 @@ LivLiv Player と `.livliv` 形式は LivLiv が独自に開発したもので
livliv.ai でのキャラクター制作には AI を使います。プレイヤー自体は再生するだけです。AI のサービスを呼び出すことはなく、指定されたファイルだけを読み込みます。フェイストラッキングはブラウザ内で Google の MediaPipe を動かし、カメラの映像は端末の外に出ません。通信について詳しくは API.md をご覧ください。
-このリポジトリの厳選キャラクターも LivLiv で作ったもので、同じく AI を使っています。Nana のリファイン版(`d03ft`)には、LivLiv 独自のツールで揺れるパーツと振り向きのキーフォームを加えています。
+このリポジトリの厳選キャラクターも LivLiv で作ったもので、同じく AI を使っています。Kujira、Kujira Q、Pen は他の方のキャラクターを翻案したものです([クレジット](characters/CREDITS.md))。Nana のリファイン版(`d03ft`)には、LivLiv 独自のツールで揺れるパーツと振り向きのキーフォームを加えています。
パッケージの `meta.author` と `meta.license` は、クレジットと利用条件を記したものです。残したうえで従ってください。LivLiv で作ったキャラクターを公開するときは AI が制作に関わっていることを明記し、手描きや手作業のリギングによる作品として紹介しないでください。
diff --git a/README.md b/README.md
index a694aa8..3eb3f83 100644
--- a/README.md
+++ b/README.md
@@ -75,11 +75,14 @@ are described in [FORMAT-v3.md](FORMAT-v3.md) and still play.
## Featured characters
-`characters/` holds 21 characters made by LivLiv, ready to `load()`. They carry a small LivLiv mark in the
-bottom-right corner, which the player draws. They are **not** covered by the Apache License: use them free for personal, non-commercial projects with credit
+`characters/` holds 21 characters, ready to `load()`. They carry a small LivLiv mark in the bottom-right corner, which
+the player draws. They are **not** covered by the Apache License. Most were made by LivLiv: use those free for personal, non-commercial projects with credit
("Characters: LivLiv (livliv.ai)"); don't sell them, use them commercially or train AI models on them. Nana is
LivLiv's mascot. The terms are in [characters/LICENSE.md](characters/LICENSE.md).
+Kujira, Kujira Q and Pen come from other people's work: that licence and that credit don't cover them. Their sources,
+credits and terms are in [characters/CREDITS.md](characters/CREDITS.md).
+
| id | name | id | name | id | name |
|---|---|---|---|---|---|
| `k01` | Sena | `d01` | Yui | `v01` | Aster |
@@ -110,7 +113,8 @@ Making a character on livliv.ai uses AI. The player itself only plays: it calls
you point it at. Face tracking runs Google's MediaPipe in the browser, and camera images stay on the device; API.md has
the networking details.
-The featured characters in this repository were made on LivLiv too, also with AI. Refined Nana (`d03ft`) also has
+The featured characters in this repository were made on LivLiv too, also with AI; Kujira, Kujira Q and Pen adapt other
+people's characters ([credits](characters/CREDITS.md)). Refined Nana (`d03ft`) also has
swinging parts and head-turn keyforms added with LivLiv's own tools.
A package's `meta.author` and `meta.license` record who made it and on what terms: keep them and follow them. When you
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 5bca6ca..ed70538 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -73,7 +73,9 @@ await png.load({ closed: 'me-closed.png', open: 'me-open.png' })
## 精选角色
-`characters/` 里是 LivLiv 制作的 21 个角色,可以直接 `load()`。它们右下角带一个小小的 LivLiv 标,播放器会画出来。它们**不**适用 Apache 许可:个人非商业用途可以免费使用,请署名(「角色:LivLiv(livliv.ai)」);不能出售、不能商用、不能用来训练 AI 模型。Nana 是 LivLiv 的吉祥物。完整条款见 [characters/LICENSE.md](characters/LICENSE.md)。
+`characters/` 里有 21 个角色,可以直接 `load()`。它们右下角带一个小小的 LivLiv 标,播放器会画出来。它们**不**适用 Apache 许可。大部分由 LivLiv 制作:个人非商业用途可以免费使用,请署名(「角色:LivLiv(livliv.ai)」);不能出售、不能商用、不能用来训练 AI 模型。Nana 是 LivLiv 的吉祥物。完整条款见 [characters/LICENSE.md](characters/LICENSE.md)。
+
+Kujira、Kujira Q 和 Pen 来自别人的作品,不适用上面的许可和署名。它们的来源、署名和条款见 [characters/CREDITS.md](characters/CREDITS.md)。
角色列表见[英文 README](README.md#featured-characters)。
@@ -91,7 +93,7 @@ LivLiv Player 和 `.livliv` 格式是 LivLiv 独立做的,没有用 Live2D 的
在 livliv.ai 上制作角色会用到 AI。播放器本身只负责播放:不调用 AI 服务,只读取你指给它的文件。面捕在浏览器里运行 Google 的 MediaPipe,摄像头画面不离开设备;网络方面的细节见 API.md。
-仓库里的精选角色也是在 LivLiv 上做的,同样用到了 AI。Nana 精修版(`d03ft`)另外用 LivLiv 自己的工具加了会摆动的部件和转头的关键形。
+仓库里的精选角色也是在 LivLiv 上做的,同样用到了 AI;Kujira、Kujira Q 和 Pen 改编自别人的角色([来源](characters/CREDITS.md))。Nana 精修版(`d03ft`)另外用 LivLiv 自己的工具加了会摆动的部件和转头的关键形。
模型包里的 `meta.author` 和 `meta.license` 记的是署名和使用条款,请保留并遵守。公开展示用 LivLiv 做的角色时,请注明 AI 参与制作,不要说成手绘或人工绑定的作品。
diff --git a/characters/CREDITS.md b/characters/CREDITS.md
new file mode 100644
index 0000000..3e7f430
--- /dev/null
+++ b/characters/CREDITS.md
@@ -0,0 +1,43 @@
+# 角色来源
+
+大部分精选角色由 LivLiv 团队借助 AI 制作。有三个来自别人的作品。
+
+## Kujira(p01)、Kujira Q(p02)
+
+基于社区角色「鲸鱼娘」:
+
+- 原创角色溟月,作者上善无形:https://www.bilibili.com/opus/1231977657712771073
+- 女仆设计,作者 ZipZipPipe:https://www.bilibili.com/video/BV1tE9XBbErS/
+
+这两个文件夹采用 CC BY-NC-SA 4.0(https://creativecommons.org/licenses/by-nc-sa/4.0/),不适用 LivLiv 精选角色许可。LivLiv 借助 AI,根据两张现成的图片把它们做成分层、绑定的模型;这两张图的画师我们还没能确认。如果其中一张是你画的,请发邮件到 [email protected],我们会为你署名。
+
+署名:「Kujira:上善无形、ZipZipPipe(CC BY-NC-SA 4.0);模型:LivLiv」。这是非官方的社区角色,与 DeepSeek 无关。
+
+## Pen(p03)
+
+基于粉丝角色「咕咕嘎嘎」(Gugu Gaga penguin),由贱兔死顺盖根据《明日方舟:终末地》(鹰角网络)里的管理员创作;也参考了一张标有 "GUGA" 的手办照片,制作者不明。
+
+Apache 许可和 LivLiv 精选角色许可都不适用于 Pen。LivLiv 对这个角色不持有任何权利,也不授予任何权利。如果你持有相关权利,请发邮件到 [email protected],我们会为你署名或移除这个角色。
+
+---
+
+# Character credits
+
+Most featured characters were made by the LivLiv team with AI. Three come from other people's work.
+
+## Kujira (p01), Kujira Q (p02)
+
+Based on the community "whale girl" (鲸鱼娘):
+
+- Original character 溟月 by 上善无形: https://www.bilibili.com/opus/1231977657712771073
+- Maid design by ZipZipPipe: https://www.bilibili.com/video/BV1tE9XBbErS/
+
+These two folders are under CC BY-NC-SA 4.0 (https://creativecommons.org/licenses/by-nc-sa/4.0/), not the LivLiv Featured Characters License. LivLiv adapted them into layered, rigged models with AI, from two existing pictures whose artists we haven't identified. If one is yours, email [email protected] and we'll credit you.
+
+Credit: "Kujira: 上善无形, ZipZipPipe (CC BY-NC-SA 4.0); model by LivLiv". This is an unofficial community character, not connected with DeepSeek.
+
+## Pen (p03)
+
+Based on the fan character known as 咕咕嘎嘎 (Gugu Gaga penguin), made by 贱兔死顺盖 from the Administrator in Arknights: Endfield (Hypergryph), and on a photo of a figure marked "GUGA", maker unknown.
+
+Neither the Apache License nor the LivLiv Featured Characters License covers Pen. LivLiv holds no rights in this character and grants none. If you hold rights in it, email [email protected] and we'll credit or remove it.
diff --git a/characters/LICENSE.md b/characters/LICENSE.md
index c1e8b78..1499aa6 100644
--- a/characters/LICENSE.md
+++ b/characters/LICENSE.md
@@ -1,8 +1,8 @@
# LivLiv 精选角色许可
-版本 1.0,2026 年 11 月 5 日
+版本 1.0,2026 年 11 月 6 日
-随 LivLiv Stage 和 LivLiv Player 提供的角色(每个角色文件夹里的模型、贴图和头像,下称「精选角色」)由 LivLiv 团队借助 AI 制作。LivLiv 保留这份许可没有授予的权利。LivLiv Stage 和 LivLiv Player 的代码另有许可,这份许可只管精选角色。
+除 Kujira(p01)、Kujira Q(p02)和 Pen(p03)外,随 LivLiv Stage 和 LivLiv Player 提供的角色(每个角色文件夹里的模型、贴图和头像,下称「精选角色」)由 LivLiv 团队借助 AI 制作。这份许可不包括这三个角色,它们的来源和条款见 CREDITS.md。LivLiv 保留这份许可没有授予的权利。LivLiv Stage 和 LivLiv Player 的代码另有许可,这份许可只管精选角色。
## 可以
@@ -37,9 +37,9 @@ Nana(d03、d03ft)是 LivLiv 的吉祥物。除了上面的规则,还要遵
# LivLiv Featured Characters License
-Version 1.0, November 5, 2026
+Version 1.0, November 6, 2026
-The characters that come with LivLiv Stage and LivLiv Player (the models, textures and avatars in each character's folder, the "Featured Characters") were made by the LivLiv team with AI. LivLiv keeps the rights this license does not grant. The code of LivLiv Stage and LivLiv Player has its own license; this license covers only the Featured Characters.
+Except for Kujira (p01), Kujira Q (p02) and Pen (p03), the characters that come with LivLiv Stage and LivLiv Player (the models, textures and avatars in each character's folder, the "Featured Characters") were made by the LivLiv team with AI. This license does not cover those three: see CREDITS.md for where they come from and their terms. LivLiv keeps the rights this license does not grant. The code of LivLiv Stage and LivLiv Player has its own license; this license covers only the Featured Characters.
## You may
diff --git a/characters/index.json b/characters/index.json
index cd334c5..477b73c 100644
--- a/characters/index.json
+++ b/characters/index.json
@@ -33,15 +33,18 @@
},
{
"id": "p01",
- "name": "Kujira"
+ "name": "Kujira",
+ "credit": "Kujira: 上善无形, ZipZipPipe (CC BY-NC-SA 4.0); model by LivLiv"
},
{
"id": "p02",
- "name": "Kujira Q"
+ "name": "Kujira Q",
+ "credit": "Kujira Q: 上善无形, ZipZipPipe (CC BY-NC-SA 4.0); model by LivLiv"
},
{
"id": "p03",
- "name": "Pen"
+ "name": "Pen",
+ "credit": "Pen: based on 咕咕嘎嘎 by 贱兔死顺盖; LivLiv holds no rights in this character"
},
{
"id": "q02",
diff --git a/characters/p01/model.json b/characters/p01/model.json
index ffa49a4..c717e11 100644
--- a/characters/p01/model.json
+++ b/characters/p01/model.json
@@ -7,10 +7,13 @@
"name": "livliv.ai"
},
"created": "2026-11-05T09:51:41Z",
+ "author": {
+ "name": "上善无形, ZipZipPipe"
+ },
"license": {
- "id": "LicenseRef-LivLiv-Samples",
- "url": "https://livliv.ai/licenses/samples",
- "text": "LivLiv Featured Characters License 1.0: free for non-commercial use with credit (\"Characters: LivLiv (livliv.ai)\"); no selling or separate distribution, no commercial use without permission, no AI training. The full text is LICENSE.md beside the characters."
+ "id": "CC-BY-NC-SA-4.0",
+ "url": "https://creativecommons.org/licenses/by-nc-sa/4.0/",
+ "text": "CC BY-NC-SA 4.0: see CREDITS.md beside the characters."
},
"watermark": {
"kind": "livliv",
diff --git a/characters/p02/model.json b/characters/p02/model.json
index a9578b1..1c143d5 100644
--- a/characters/p02/model.json
+++ b/characters/p02/model.json
@@ -7,10 +7,13 @@
"name": "livliv.ai"
},
"created": "2026-11-05T10:05:34Z",
+ "author": {
+ "name": "上善无形, ZipZipPipe"
+ },
"license": {
- "id": "LicenseRef-LivLiv-Samples",
- "url": "https://livliv.ai/licenses/samples",
- "text": "LivLiv Featured Characters License 1.0: free for non-commercial use with credit (\"Characters: LivLiv (livliv.ai)\"); no selling or separate distribution, no commercial use without permission, no AI training. The full text is LICENSE.md beside the characters."
+ "id": "CC-BY-NC-SA-4.0",
+ "url": "https://creativecommons.org/licenses/by-nc-sa/4.0/",
+ "text": "CC BY-NC-SA 4.0: see CREDITS.md beside the characters."
},
"watermark": {
"kind": "livliv",
diff --git a/characters/p03/model.json b/characters/p03/model.json
index 503db30..34b0488 100644
--- a/characters/p03/model.json
+++ b/characters/p03/model.json
@@ -8,9 +8,9 @@
},
"created": "2026-11-04T15:21:51Z",
"license": {
- "id": "LicenseRef-LivLiv-Samples",
- "url": "https://livliv.ai/licenses/samples",
- "text": "LivLiv Featured Characters License 1.0: free for non-commercial use with credit (\"Characters: LivLiv (livliv.ai)\"); no selling or separate distribution, no commercial use without permission, no AI training. The full text is LICENSE.md beside the characters."
+ "id": "LicenseRef-Third-Party-Character",
+ "url": "https://github.com/livliv-dev/player/blob/main/characters/CREDITS.md",
+ "text": "Not under the Apache License or the LivLiv Featured Characters License. LivLiv holds no rights in this character and grants none: see CREDITS.md beside the characters."
},
"watermark": {
"kind": "livliv",
diff --git a/example/gallery.html b/example/gallery.html
index 955b1f9..221b2c5 100644
--- a/example/gallery.html
+++ b/example/gallery.html
@@ -11,6 +11,8 @@
canvas { display: block; width: 100%; height: min(70vh, 640px); cursor: pointer }
.bar { display: flex; flex-wrap: wrap; align-items: center; gap: 6px; padding: 10px 14px }
.bar b { margin-right: auto; font-size: 15px }
+ #credit { margin: 0; padding: 0 14px 10px; color: #666; font-size: 12px }
+ #credit:empty { display: none }
.bar button { font: inherit; padding: 5px 10px; border: 0; border-radius: 8px; background: #eee; cursor: pointer }
.cast { display: grid; grid-template-columns: repeat(auto-fill, minmax(68px, 1fr)); gap: 8px; margin-top: 12px; padding: 0; list-style: none }
.cast button { width: 100%; padding: 4px; border: 2px solid transparent; border-radius: 12px; background: #fff; cursor: pointer }
@@ -22,6 +24,7 @@
<div class="stage">
<div class="view" id="view"><canvas id="stage"></canvas></div>
<div class="bar" id="bar"><b id="name"></b></div>
+ <p id="credit"></p>
</div>
<ul class="cast" id="cast"></ul>
</main>
@@ -46,7 +49,7 @@
needWebGL(Player)
const player = new Player(document.getElementById('stage'), { maxPixelRatio: 1.5 })
- const bar = document.getElementById('bar'), name = document.getElementById('name'), ul = document.getElementById('cast')
+ const bar = document.getElementById('bar'), name = document.getElementById('name'), credit = document.getElementById('credit'), ul = document.getElementById('cast')
const buttons = new Map()
let current = null, exprs = [], next = -1
@@ -76,6 +79,12 @@
}
if (id !== current) return // another was picked meanwhile
name.textContent = m.name
+ credit.replaceChildren()
+ const said = cast.find((c) => c.id === id)?.credit // a character from other people's work
+ if (said) {
+ const more = document.createElement('a'); more.href = '../characters/CREDITS.md'; more.textContent = 'credits'
+ credit.append(`${said} · `, more)
+ }
exprs = m.expressions; next = -1
bar.querySelectorAll('button').forEach((b) => b.remove())
for (const x of [{ id: null, label: 'neutral' }, ...m.expressions]) {
diff --git a/example/pages-index.html b/example/pages-index.html
index cab6ae5..a94f2b0 100644
--- a/example/pages-index.html
+++ b/example/pages-index.html
@@ -20,7 +20,7 @@
<li><a href="example/index.html">The few lines it takes</a></li>
<li><a href="example/png.html">A PNGTuber</a> and <a href="example/vrm.html">a VRM</a> on the same API</li>
</ul>
- <p><small>The featured characters are LivLiv's, under their own licence (characters/LICENSE.md in the repository); the
+ <p><small>The featured characters are under their own terms (characters/LICENSE.md and characters/CREDITS.md in the repository); the
code is under the Apache License 2.0.</small></p>
</main>
</html>
diff --git a/test/characters.test.ts b/test/characters.test.ts
index 654f696..7dc5d61 100644
--- a/test/characters.test.ts
+++ b/test/characters.test.ts
@@ -15,6 +15,7 @@ const LANGS = ['en', 'zh', 'zh-Hant', 'ja']
describe('featured characters', { skip: !ids.length && 'no characters/ here' }, () => {
it('come with their licence, and a list of them all', () => {
assert.ok(existsSync(join(root, 'LICENSE.md')))
+ assert.ok(existsSync(join(root, 'CREDITS.md')))
const list = JSON.parse(readFileSync(join(root, 'index.json'), 'utf8')) as { id: string; name: string }[]
assert.deepEqual(list.map((c) => c.id), ids)
for (const c of list) assert.equal(c.name, JSON.parse(readFileSync(join(root, c.id, 'model.json'), 'utf8')).name)
@@ -27,7 +28,7 @@ describe('featured characters', { skip: !ids.length && 'no characters/ here' },
assert.equal(raw.format, FORMAT)
assert.ok(raw.version <= FORMAT_VERSION)
assert.deepEqual(raw.requires ?? [], [])
- assert.equal(raw.meta?.license?.id, 'LicenseRef-LivLiv-Samples')
+ assert.equal(raw.meta?.license?.id, { p01: 'CC-BY-NC-SA-4.0', p02: 'CC-BY-NC-SA-4.0', p03: 'LicenseRef-Third-Party-Character' }[id] ?? 'LicenseRef-LivLiv-Samples')
assert.equal(raw.meta?.watermark?.kind, 'livliv') // the LivLiv logo, in the corner only (owner 11-04)
assert.equal(raw.meta?.watermark?.center, false)
for (const e of raw.expressions || []) assert.deepEqual(LANGS.filter((l) => !e.label?.[l]), [], `${e.id}'s names`)
diff --git a/test/smoke.mjs b/test/smoke.mjs
index d23b7e6..8243346 100644
--- a/test/smoke.mjs
+++ b/test/smoke.mjs
@@ -59,7 +59,7 @@ try {
for (const r of out) {
// the featured characters carry the LivLiv mark in the corner only: the player must draw it there and nowhere else
const ok = !r.error && r.share > 0.05 && r.glError === 0 && r.watermark === 'LivLiv' && r.mark > 0.001 && r.outside < 0.0003 && r.noise < 0.0005
- && r.license === 'LicenseRef-LivLiv-Samples'
+ && r.license === ({ p01: 'CC-BY-NC-SA-4.0', p02: 'CC-BY-NC-SA-4.0', p03: 'LicenseRef-Third-Party-Character' }[r.id] ?? 'LicenseRef-LivLiv-Samples')
if (!ok) failed++
console.log(`${ok ? 'ok ' : 'FAIL'} ${r.id.padEnd(6)} ${r.error ?? `${r.name} (${r.format}), ${r.expressions}, covers ${(r.share * 100).toFixed(1)} %, mark ${r.watermark} on ${(r.mark * 100).toFixed(2)} % (outside the corner ${(r.outside * 100).toFixed(2)} %, noise ${(r.noise * 100).toFixed(2)} %), ${r.ms} ms${r.glError ? `, GL error ${r.glError}` : ''}`}`)
}