CodeX Core CXC
Hello everyone, my name is Rion. This is my boredom project, which might be useful for you. This tool has several features such as:
Features
- Download Music with yt-dlp
- Search Music with yt-dlp
- Video Downloader (DV)
- Local Search
- mpx Music Player X
- AI Chat
- Self Update via pipx
How to use
cxc help
Commands
| Command | Alias | Description |
|---|---|---|
cxc search "<title>" |
-S |
Search music information |
cxc search --local "<title>" |
Search your downloaded files locally | |
cxc download "<title>" |
-D |
Search and download music to MP3 |
cxc DV -r "<res>" "<URL>" |
Download a video at a chosen quality | |
cxc mpx |
Open Music Player X | |
cxc chat |
Open the AI chat menu | |
cxc time |
-t |
Show time, day, month, and year |
cxc update |
-U |
Self update via pipx upgrade cxc |
cxc version |
-v |
Show the current version |
cxc help |
h |
Display the help menu |
Configuration
cxc stores its settings in ~/.config/cxc/config.toml (TOML format). The file is created automatically on first run — just edit it and restart cxc.
# CodeX Core (cxc) configuration
# --- AI credentials ---
API = "PASTE_YOUR_API_KEY"
MODEL = "gemini-2.5-flash"
AI_NAME = "Your_Ai_Name"
# AI_PROMPT may reference other keys, e.g. {AI_NAME}
AI_PROMPT = "You Are {AI_NAME}"
# --- Folders (relative to your home directory) ---
MUSIC_DIR = "Music"
VIDEO_DIR = "Videos"
| Key | Description |
|---|---|
API |
Your Gemini API key (required for cxc chat). |
MODEL |
The AI model to use, e.g. gemini-2.5-flash. |
AI_NAME |
The name shown for the AI in chat. |
AI_PROMPT |
The system prompt. May reference other keys, e.g. {AI_NAME}. |
MUSIC_DIR |
Folder for downloaded music, relative to your home directory. |
VIDEO_DIR |
Folder for downloaded videos, relative to your home directory. |
Config format & migration
The configuration format changed from a Python file (config.py) to TOML (config.toml). You don't need to do anything manually:
- If you upgrade from an old version, cxc migrates automatically the first time you run it:
- reads your old
config.py, - writes the new
config.toml, - keeps a backup of the old file as
config.py.bak, - removes the old
.lockfile.
- reads your old
- Your API key and all other settings are preserved.
- If you have no old config, a fresh
config.tomlis created for you. - The file is stored with owner-only permissions (
600) because it holds your API key. - cxc now requires Python 3.11+ (for the built-in
tomllib).
Update
What's New in v1.0.0 (First Stable Release)
- Video Downloader (DV) — download videos with yt-dlp and pick the resolution, e.g.
cxc DV -r "360" "<URL>". - Self Update — update cxc straight from the terminal using
pipx upgrade, e.g.cxc update. - Local Search — find your downloaded music/videos on your device with partial-title and typo-tolerant matching, e.g.
cxc search --local "<music title>". - New config format — configuration moved from
config.pytoconfig.toml, with automatic migration from the old file. See the Configuration section.
Notes
- Before using the chat feature, please set your configuration first in
~/.config/cxc/config.toml(see Configuration). - The
1.26.xversions were the nightly channel. v1.0.0 is the first stable release of CXC, so the versioning restarts from here.
I will update regularly but I can't guarantee it, so see you in the next update.
Metadata
Release files for cxc 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| cxc-1.0.0.tar.gz | 10.5 kB | Without provenance | Details for cxc-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cxc-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for cxc-1.0.0-py3-none-any.whl |
Total release size: 22.4 kB
Release files / cxc-1.0.0.tar.gz
| Download URL | cxc-1.0.0.tar.gz |
|---|---|
| Size | 10.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2bb9197a4a44f8e5de70db63526a51becab6035b286fe625f9873a5dd137a3d4
|
|
BLAKE2b-256 checksum How to use checksums |
374c30d7da1ee2e796abb3c1343ef789d3d723f5c6ca4d80608390c18b2430f3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Release files / cxc-1.0.0-py3-none-any.whl
| Download URL | cxc-1.0.0-py3-none-any.whl |
|---|---|
| Size | 11.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b7f183ec17786b9207584df1ac093be4e186bb073a4e4de69ac35654ee0be8b0
|
|
BLAKE2b-256 checksum How to use checksums |
2f9021e2ea2d6cd4a1880a13888036f2b9455f72a00ef022eeefd0ddbeeca7c4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Security for cxc 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.