Skip to main content

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:
    1. reads your old config.py,
    2. writes the new config.toml,
    3. keeps a backup of the old file as config.py.bak,
    4. removes the old .lock file.
  • Your API key and all other settings are preserved.
  • If you have no old config, a fresh config.toml is 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.py to config.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.x versions 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)

Source distribution for cxc 1.0.0
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)

Table of built distributions (wheels) for cxc 1.0.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page