Skip to content

About

cccodroid 社区组件配方贡献仓库;用于桥接组件开发、测试及上游协作。

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

cccodroid-components

中文

Community component recipes for cccodroid, the Android launcher for Claude Code.

A component is an optional software bundle that you install from cccodroid's Extensions page. Examples include the GitHub CLI, LibreOffice, circuit simulators and local LLM inference. Once installed, Claude inside cccodroid can use it. Each component ships a skill that tells Claude how to use it and what to watch out for.

cccodroid reads this repository since 0.1.10. Preset components such as the browser (Chromium) are still published from the cccodroid repository.

Components

id What it is Category Notes Upstream license
gh GitHub CLI: pull requests, issues, releases, Actions Dev MIT
godot Godot 4 engine: headless runs, Android APK export Dev MIT
diagrams Diagrams from text: Graphviz (flowcharts, structure diagrams) + PlantUML (sequence, class diagrams), to SVG / PNG, with Chinese labels Dev EPL-2.0 AND GPL-3.0-or-later AND GPL-2.0-with-classpath-exception
hugo Hugo: static websites from Markdown, with local preview and builds Dev Apache-2.0
re-tools Reverse engineering: rizin for ELF / .so info and disassembly; binwalk for archives and filesystems inside firmware Dev LGPL-3.0-or-later AND MIT
blender Headless Blender 4.3: Python-scripted compositing, motion graphics and video output; 3D rendering on the Adreno GPU (Vulkan 1.4) Media Downloads the engine on first use: about 267 MB from Debian plus an 11 MB patched Mesa for the GPU (the setup follows blender-cli-android) GPL-2.0-or-later
lilypond LilyPond: music notation from plain text — publication-grade PDF, plus PNG, SVG and MIDI Media GPL-3.0-or-later
music Music production toolchain: MIDI to audio (fluidsynth), SuperCollider synthesis, sox mastering, aubio analysis Media Bundles a GM soundfont (31 MB) LGPL-2.1-or-later AND GPL-3.0-or-later AND GPL-2.0-only AND LicenseRef-GeneralUser-GS-2.0
libreoffice Headless LibreOffice: convert documents, export PDF Office MPL-2.0 AND LGPL-3.0
pandoc Pandoc: convert between Markdown, Word, HTML, EPUB and PDF; PDF via the bundled typst Office GPL-2.0-or-later
pdf-tools PDF toolbox: merge, split, rotate, encrypt/decrypt, shrink, extract text, render to images (qpdf, poppler, mutool) Office Apache-2.0 AND GPL-2.0-or-later AND AGPL-3.0-or-later
ocr OCR: text from images and scanned PDFs in Simplified Chinese, Traditional Chinese and English, plus searchable PDFs Office Language models are downloaded at install Apache-2.0 AND GPL-2.0-or-later
latex LaTeX (Tectonic): .tex to PDF with ctex / xeCJK Chinese and beamer Office First compile downloads and caches TeX resources MIT
llama-cpp llama.cpp: local LLM inference AI Bring your own model (.gguf) MIT
openscad OpenSCAD: script-based 3D modelling, STL and other exports, with the MCAD library 3D & CAD GPL-2.0-only
octave GNU Octave: MATLAB-compatible numerical computing with headless plots (bundles gnuplot) Science GPL-3.0-or-later AND gnuplot
sci-python Scientific Python: numpy, scipy, matplotlib, Pillow, pyarrow, all prebuilt Science BSD-3-Clause AND PSF-2.0 AND MIT-CMU AND Apache-2.0
ngspice ngspice: circuit simulation EDA BSD-3-Clause AND LGPL-2.1-only
gnucap gnucap: circuit simulation EDA GPL-3.0-or-later
iverilog Icarus Verilog: Verilog simulation, waveforms rendered to images EDA GPL-2.0-or-later
yosys Yosys: Verilog synthesis EDA ISC
gpu-driver Gives command-line programs access to the Adreno GPU: Turnip (Vulkan) + zink (OpenGL / GLES) GPU Snapdragon only MIT
gpu-driver-glibc The same for glibc (Linux arm64) programs, with the lgpu-run launcher GPU Snapdragon only MIT
gpu-driver-mali Gives command-line programs the Mali GPU: the vendor Vulkan / GLES driver via the system loader, no root GPU Mali only (Dimensity etc.); Termux programs only, no OpenCL Apache-2.0
clvk-glibc OpenCL (clvk, on top of Vulkan) for glibc programs GPU Snapdragon only; needs gpu-driver-glibc Apache-2.0
gpu-bench GPU info and benchmarks (clinfo / vkmark / clpeak) GPU Snapdragon only; needs gpu-driver CC0-1.0 AND GPL-3.0-or-later AND GPL-2.0-or-later
cloudflare Cloudflare CLI (wrangler): deploy Workers and Pages, manage R2 / KV / D1, run wrangler dev locally Net Log in with cf-login by pasting a token (MIT OR Apache-2.0) AND Apache-2.0
rclone rclone: sync and back up local folders, WebDAV, S3, Google Drive and more Net MIT

Every component in the table has been verified on a real device with the current toolchain (devkit-2026.10.28). Some were tested directly; others inherited a verification from an earlier toolchain (see "Device verification" below). The records are in verified.json.

The app won't offer "Snapdragon only" components on devices with other chips. For components with dependencies, the app asks you to install those first and won't let you remove them while something still depends on them.

Published but not yet verified on a device

The app labels these "not verified on a device". Read the description before installing.

  • openai-bridge (preview): turns an OpenAI Chat Completions API you're allowed to use into a local Anthropic Messages endpoint, which you then enter under Settings → Provider & model → Custom endpoints. Requests go to the remote service you configure and may cost money; the bridge only listens on the loopback address. After installing, run openai-bridge configure in the terminal; before removing it in the app, run openai-bridge uninstall --yes. About 107 MiB. Source: chenshi723/cccodroid-openai-bridge.

How it works

  • This repo holds recipes only, no binaries. A recipe lists Termux package names. CI downloads the official Termux .deb files, checks every SHA-256, rewrites the prefix from com.termux to cc.codroid (same length, byte for byte), and packs the result. A recipe may also declare an upstream artifact with fetch (URL plus SHA-256). This is only for artifacts the component needs at runtime that the official repository doesn't have; CI downloads and checks them.

  • One build per toolchain version. Components contain only what the cccodroid toolchain lacks, so each one is built against every toolchain listed in bases.json. The app installs the build that matches the user's toolchain. When cccodroid ships a new toolchain, it gets a line here.

  • Signed index. CI publishes components.json to the index release with an ed25519 signature (components.json.sig). The app checks it against a built-in public key, so a tampered index or package won't install.

  • Device verification. verified.json lists builds that were installed on a real device, passed their self-test and uninstalled cleanly. Anything not listed shows as "not verified on a device" in the app. After a new toolchain, a build inherits the earlier record if neither the component's packages nor the toolchain packages it relies on have changed. Only builds that actually changed need a new test.

  • Audit. Every pull request runs the format check (check-recipes.mjs). Then audit.mjs builds the package for real and checks:

    • missing libraries and script interpreters;
    • files that would overwrite the toolchain, and leftover Termux paths;
    • anything in the skill that a human should look at (tokens, downloads, delete or publish steps, privilege escalation).

    The audit report rates each component as 🟢 read the report, 🟡 read the scripts and skill, or 🔴 review line by line.

Adding a component

Read the authoring rules, then CONTRIBUTING.md and the recipe format. Looking for something to build? Wanted components lists candidates the maintainer won't build alone, with the test results so far; claim one in #52. The quickest start is to copy recipes/gh/. For larger examples with wrapper scripts, see recipes/iverilog/ or recipes/llama-cpp/.

If an AI assistant writes the component for you, AGENTS.md at the repository root is written for it.

The market doesn't accept components for reverse proxies, shared or resold accounts, jailbreaking or mass-controlled accounts, and removes any it finds (see "Not accepted" in CONTRIBUTING.md). These practices end up hurting ordinary users; cccodroid's position is in What this project stands against.

Thanks

Thank you, in order of contribution:

  • CCB-Fox: contributed gpu-driver-mali (#46), the first external component. Worked out on a Dimensity 9400 how to use the vendor Mali driver through the system Vulkan loader without root, which is why needs.gpu: "mali" exists.
  • Cosmosophius: a thorough Dimensity 9300 (Mali-G720) report (#47) that independently confirmed the same approach and measured compute performance, extension support and the dead ends.

GitHub's contributor list only counts commits. Reports and device testing are contributions too, and they're recorded here.

License

Recipes, scripts and documentation in this repository are Apache-2.0. Packaged software keeps its upstream license, recorded in each recipe.

About

cccodroid 社区组件配方贡献仓库;用于桥接组件开发、测试及上游协作。

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages