🎨 ASCII-Me CLI
Convierte imágenes y GIFs animados en arte ASCII a color, directamente en tu terminal.
Compatible con Linux, macOS y Windows 🖥️.
🚀 Instalación
Desde PyPI (recomendado)
pip install ascii-me-cli
Desde GitHub (última versión de desarrollo)
git clone https://github.com/WetZap/Ascii-Me.git
cd Ascii-Me
pip install .
📌 Uso
🔹 Imagen estática
ascii-art --mode image --file ejemplo.png
🔹 GIF animado
ascii-art --mode gif --file ejemplo.gif
🔹 Eliminar fondo (opcional)
ascii-art --mode gif --file ejemplo.gif --remove-bg
👉 Si no pasas --file, tomará automáticamente la primera imagen o GIF encontrado en el directorio actual.
🎬 Ejemplo
Aquí un ejemplo de cómo se ve una imagen convertida en ASCII dentro del terminal:
#**M #*#*# #* *
*#* ##o*o# *****# **o*oooo#***# *M*Moo**o*o** *W* oo
#o*# ****** ******o **o** o*** ##* ***
##o ****o**** *** o**oo** oo *#** *****
** **o**# **oo*oo*o *** *#
98)
877(r)806
8779/YOQZCvxt(9890
7770tzm*@%mCCJUUUYznt089(
0877)jUqM@$$%aQUUUUUYYYUUUXx(89|
877)rCd&$$$8*bZLUUUUUUUUYYYYYUUYf98)
0444444443 \098/YpMBB&*kqZQCJUUUUUUUUYYYYYYXzUJJx890
(9)LZOQLCUXvxjt\(0879)0898\oMadw0CXvnXJYYYYYYYYYYYYYYYr)//nYLt89(
/97u$$$$$$$B8&&M*akpO/98\Z(9CLXurjnYL09cUYYYYYYYYYYYUz|0QowYuvf8988788899990000000999887770)
)97z$$$@oUYYYUC0mdh#k087C8wunvzCwh*#Mw|8rYUUYUYYYUUYr9rb#*#MMat76jOZZwwpddbkkkhhhhkbdqwZOY990
097x$@&WC577777779)\f988\qMM##M###***#hX))rzUJCJUXx(tO*#**##bj69caMMMMM#*ohbdqwZOOZp###MMv78)
)980aW*#p98888888887787767rQbo####*****#hQnttjxrjfvZo#**odQn00vp*kqOCXurt|)09887775n***#U799
997jo**#Y788888888879tXQv\90\xzLmko*ooo*#*obpqqba#***bJnfjc0k*oc07777777888888887na**#J899
997u****c788888870vwo***obwQJYXJqoooooooo*******ooooakha***ooohOn)7888888888878Y****Y799
997v****X77887)zb**ooooo********oooooooooooooooooooooooooooooo**bX)788888887tm***hn799
997uo**#Oj(|ud#*ooooooooooooooooooooooooooo*o***ooooooooooooooo*#bz)77778tQo**#w/790
087ra*o**aa**oooooooooooooooaooooooooooooooo*ahooooooooooooooooo*#kXttuZo#*#oU989)
)97fb#****ooooooooo******kLUChooooooooooooowUYCh****#*ooooooooooo*#o*##**#qf780
0877990090860Cmbo#oooooooooqYxjxOkZ0Zaooooo**oooooopOOqokXxxc0hooooooo****##*ohkbX7688
099jwh***ohbw0JcxfjL*oooooo*U766650b#**oooooappaoooooo****v46665\k*ooooooo*wUcuuuuvnuvccunj)9)
)98)rX0qka#MWM###appooooooo*0j//jcwoooooooookLCb*oooooooo*qvt|\jJaoooooooo*pZqba*#MWWM#abOc09(
08|jt(80|fcd*ooo**oooooooo**oo*#*oooooooooo***oooooooo**##*oo*#ooooooo****#*kqZQJzurf/(98099
9|wZv/jcCOZwa#*******ooo***#######################****ooahbpd****o**********aCcvxf/\\\trnxrf|990
)9xd(67XZqpppqqqwmmZwk*#*akpm0CUYXzccccccczzzzzzzccunxrjtt//)9xo######*ooahhho*##MM#okwv7)nvux/900
09/jzOYnt\\||||\||/\)tujttjnXCOwpdbkkbdqZLXuxrjjfjrxnnnnnuvf87LmLYzvnxrjf///tfrrrrrrjt/trnuuf\|)098
09/Oa#awLXvuuuuvvuun()xJqo8$$$$$@8MokqOLUXcuunnnnnuvvvuuuuun|79\/tffjrrrrrrrrjjrrrrrrrxnunnnuvvvvun\89
/98mMmUzvnxxnuuunnnuzYZkhhbqm0LUXcunxxrrrrrrrxxxxnnnnnnnnxx/09|jxxxxxxxxxxxxxxxxxxxnnnnnnxxrjf/\|||\(89)
99|vvnxnxrfftjuunnnnnnxrrrjjjrjrrrrrrrrrrrxxxxxxnnnnxxnxrrjfrxxxxxxrrxnunnnxxxxxrjf/|(0)0988877
088(frt)98089\nvuunnnxxxxxxxxxxxxxxxxxxxxxxxnnnnnxxxxxxxxxxxxxnnnnj()(tjtt/\\||\txcCOn77
88889 )99|frxnnnnxxxxxxxnnnnnnnnnnnnnnnxxxxrjjjjffffffjjjrrxxnr|70XUCL|8Za*#MMMhcczcr98
8899)((||\/tttttftt///\|||(((|||\\/ttffjrrxxxxrjjft/\\(6/#MM&u5LM***o**MWqzurfxt0)
)7\qOCYzvunnxnuuuczXUCQOZwpdbkhaoo****##*###****ahbpZOb**Mq07m#****oooahkdwQYj78
&&W&&&&W&8Z08L*W&&WWWMW#dh#WWWWMWWWMMMMMMM#MM###M##oqm*#######MM#obY80juvvvvvvccczXXXJQpM%&&&&&
8&&WW&&&88%%%hYtfvJ0ZmmmZL|9jXYUUJCCCLLLQQQQQLLCCJUYz/7jmqqppqmOLJzj/fL*8WMM##MMWW&&&&&&&&&WWW&&&
MWWWWW%B*ZXuxxxnvcYCOwmOOQLLCJJJJJJJJJJJJCLL0Z0LUXzzzzzzzXYJOd#%8&888888&8&W&W&
$$$@$@$@@@@$$$$$$@
❯
(Ejemplo simplificado de salida real — cada terminal puede variar en colores y densidad)
🛠 Desarrollo
Ejecutar sin instalar:
python ascii_gif_player.py --mode image --file ejemplo.png
Instalar dependencias en local:
pip install -r requirements.txt
📦 Dependencias
- Pillow (procesamiento de imágenes)
- Librerías estándar de Python (
argparse,os,sys, etc.)
🗺️ Roadmap
- Guardar ASCII resultante en archivo
.txt - Exportar animaciones ASCII como
.mp4o.gif - Añadir soporte para vídeos (
.mp4,.webm) - Más estilos de paletas ASCII
🤝 Contribuciones
¡Las PRs son bienvenidas! Para cambios mayores, abre un issue primero y discutamos la propuesta.
- Haz un fork 🍴
- Crea una rama:
git checkout -b feature/nueva-funcion - Haz commit:
git commit -m "feat: nueva función" - Haz push:
git push origin feature/nueva-funcion - Abre un Pull Request ✅
📜 Licencia
Distribuido bajo licencia MIT.
Consulta el archivo LICENSE para más información.
✨ Creado con ❤️ por WetZap
1 maintainer
Metadata
1 maintainer
Release files for ascii-me-cli 0.1.4
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 | |
|---|---|---|---|---|
| ascii_me_cli-0.1.4.tar.gz | 8.1 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ascii_me_cli-0.1.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 16.3 kB
Release files / ascii_me_cli-0.1.4.tar.gz
| Download URL | ascii_me_cli-0.1.4.tar.gz |
|---|---|
| Size | 8.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
21a35de10103e0e1bf7ef9f648e77ed69527256fcffcad822a50e81660cb8413
|
|
BLAKE2b-256 checksum How to use checksums |
f9260b0baa10e2a807af997e4020bdb2c4e8f60722b6e8c79ce99376a2ce8058
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.6
|
Release files / ascii_me_cli-0.1.4-py3-none-any.whl
| Download URL | ascii_me_cli-0.1.4-py3-none-any.whl |
|---|---|
| Size | 8.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c14de86078af95f75ef3708cb10e61b65ce264538e64a28868b7c1ae584c17fa
|
|
BLAKE2b-256 checksum How to use checksums |
20d47eac13aa7c4c7b476b814aa02360cbfe5f55d93f5840074f0cf7c9eb2204
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.6
|
Security for ascii-me-cli 0.1.4
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.
