🔮 Crypto 3D Sphere Terminal (crypto-3d)

Aplicación para terminales (Windows, macOS, Linux) que muestra esferas 3D volumétricas en tiempo real, dibujadas como ASCII art a color, con logotipos en relieve proyectados sobre la superficie curva, iluminación física Blinn-Phong, transiciones degradadas suaves (morph/cross-dissolve) y datos de mercado en vivo para Bitcoin (BTC), Ethereum (ETH) y Litecoin (LTC).

La escena se sombrea como una imagen RGB real y luego se resuelve a caracteres sueltos sobre negro. Dos canales llevan la imagen: la densidad sostiene la silueta (la cara oscura pierde glifos, la iluminada los agolpa) y el color separa cuerpo de emblema — la esfera va teñida y tenue, el logo va blanco. Los glifos están anclados a la superficie, así que viajan con el giro en lugar de quedarse como una rejilla fija.

🌟 Características

🚀 Instalación y Uso Rápido

Todavía no está publicado en PyPI. El nombre crypto-3d está libre, así que pip install crypto-3d hoy falla con 404. Usa la instalación local.

Opción 1: Instalación local como comando global

Desde la carpeta del proyecto:

pip install -e .

Eso deja disponibles crypto3d, crypto-3d y btc3d en cualquier terminal.

Opción 2: Ejecución directa

1. Instala las dependencias:

   pip install -r requirements.txt
   

   o

   pip install rich requests
   

2. Ejecuta la aplicación:

   python -m crypto_3d.cli
   

   o en Windows con el archivo .bat:

   crypto3d.bat
   

⚙️ Argumentos de Línea de Comandos

Ejemplos

crypto3d --coin eth --fps 30

crypto3d -c ltc --freeze

Si la esfera no sale redonda

Depende de la relación alto/ancho de la celda de tu terminal. Windows Terminal y la mayoría de fuentes monoespaciadas están cerca de 2.0, que es el valor por defecto. Si la ves achatada, sube el valor; si la ves estirada, bájalo:

crypto3d --cell-aspect 1.85

Tamaño de terminal

Maximiza la ventana. La esfera se dimensiona a lo que quede libre, así que el tamaño del terminal es lo que decide la resolución:

A partir de unas 72 columnas el ticker y las cifras de 24 h se mueven a dos columnas laterales junto a la esfera: eso llena el hueco y devuelve tres filas a la animación. Por debajo vuelven a apilarse debajo, porque las columnas ahogarían la esfera. Si el alto no da para una esfera legible, el bloque de donaciones se retira solo y le cede sus filas. Si redimensionas la ventana en marcha, todo se recalcula al vuelo.

🛠️ Añadir al PATH de Windows (Atajo Global Local)

Para escribir crypto3d desde cualquier carpeta sin instalar desde PyPI:

1. Abre el Símbolo del Sistema (CMD) como Administrador.
2. Ejecuta:

   setx PATH "%PATH%;C:\Ruta\A\Tu\Carpeta"
   

☕ Donaciones

Si te gusta el proyecto y deseas apoyar su desarrollo:

Made with love for my crypto bros ❤️

📄 Licencia

MIT License © 2026