table of contents
| AMULECMD(1) | aMule utilidades | AMULECMD(1) |
NOMBRE¶
amulecmd - Programa basado en consola para controlar aMule
SINOPSIS¶
amulecmd [-h <host>] [-p <port>] [-P <password>] [-f <path>] [-q] [-v] [-l <lang>] { [-w] | [-c <command>] } [--space-separated]
amulecmd [--create-config-from=<path>]
amulecmd [--version]
amulecmd [--help]
DESCRIPCIÓN¶
amulecmd es un cliente basado en consola para controlar aMule.
- [ -h <host>, --host=<host> ]
- Host donde se está ejecutando aMule (por defecto: 127.0.0.1). <host> debe ser o una dirección IP o un nombre DNS
- [ -p <port>, --port=<port> ]
- Puerto de conexión externa de aMule, puesto en Opciones->Controles Remotos (por defecto: 4712)
- [ -P <password>, --password=<password> ]
- Contraseña de conexiones externas.
- [ -f <path>, --config-file=<path> ]
- Usar la configuración dada por el archivo. El archivo de configuración por defecto es ~/.aMule/remote.conf
- [ -q, --quiet ]
- No mostrar ninguna salida en stdout.
- [ -v, --verbose ]
- Modo detallado - muestra también los mensajes de depuración.
- [ -l <lang>, --locale=<lang> ]
- Selecciona el idioma del programa. Ver la sección NOTAS para la descripción del parámetro del <lang>.
- [ -w, --write-config ]
- Escribe opciones de la línea de comando al archivo de configuración y termina
- [ -c <command>, --command=<command> ]
- Ejecuta <command> como si se hubiera introducido en el prompt en amulecmd, y termina.
- [ --create-config-from=<path> ]
- Crear archivo de configuración basado en <path>, el cual debe apuntar a un archivo de configuración válido, y entonces termina.
- [ --disable-ec-encryption ]
- No cifran el enlace de conexión externa. El cifrado se negocia automáticamente siempre que el aMule remoto sea compatible con él, y está activado por defecto para todos los destinos, ya sean locales o remotos. Desactivarlo deja todo lo posterior al inicio de sesión legible y modificable por cualquiera capaz de observar la conexión.
- [ --force-zlib ]
- Forzar la compresión ZLIB en el protocolo de Conexiones Externas aunque se esté conectando a una IP local/LAN. Esto es útil cuando la conexión al servidor se realiza a través de un túnel VPN que se resuelve a una IP de LAN, lo que por defecto desactivaría la compresión.
- [ --space-separated ]
- Separa los campos de los comandos de lista con espacios, como hacían las versiones anteriores, en lugar de tabulaciones. Los nombres de cliente y de archivo pueden contener espacios, por lo que el separador de tabulación predeterminado es lo que permite a un script volver a dividir una fila en sus campos; use esta opción únicamente para scripts diseñados para la salida antigua.
- [ --version ]
- Mostrar el número de la versión actual.
- [ --help ]
- Imprime una breve descripción de uso.
COMANDOS¶
Todos los comandos ignoran las mayúsculas.
Add <eD2k-link> | <magnet-link>¶
Añadir un enlace eD2k o un enlace magnet al núcleo.
El enlace eD2k para ser añadido puede ser:
El enlace magnet debe contener un hash eD2k y la longitud del archivo.
Cancel <hash> | <number>¶
Cancela la descarga especificada por <hash> o <number>. Para obtener el valor use show.
Connect [ kad | ed2k | <ip|name> ]¶
Conectar a la red.
Esto conectará a todas las redes que estén habilitadas en las preferencias.
Con el parámetro opcional, puede especificar a qué red conectarse. Al dar una dirección en formato IP:puerto (siendo IP una dirección IPv4 numérica o un nombre DNS resoluble) aMule se conectará sólo a ese servidor.
Disconnect [ ed2k | kad ]¶
Desconectar de todas las redes a las que está conectado, o desconectar solo de la red especificada.
Download <number>¶
Comenzar a descargar un archivo.
Debe proporcionarse el <number> de un fichero de la última búsqueda. Ejemplo: 'download 12' empezará a descargar el archivo con el número 12 de la búsqueda previa.
Exit¶
Desconectar de amule/amuled y salir de amulecmd.
Get <what>¶
Obtener y mostrar un valor de preferencias.
Valores disponibles para <what>:
Help [ <command> ]¶
Muestra una breve descripción de uso. Si se llama sin parámetros, muestra una lista de comando disponibles. Si se llama con <command>, mostrará una breve descripción de dicho comando.
Pause <hash> | <number>¶
Pausa la descarga especificada por <hash> o <number>. Para obtener el valor use show.
Priority <priority> <hash> | <number>¶
Fijar la prioridad de una descarga especificada por <hash> o <number>.
Valores disponibles para <priority>:
Progress [<id>]¶
Muestra el progreso de una búsqueda en curso. Opcionalmente, toma un <id> de búsqueda (como obtenido de search); sin id, muestra la última búsqueda iniciada.
Quit¶
Un sinónimo del comando exit.
Reload <what>¶
Recargar un objeto dado.
Valores disponibles para <what>:
- Recargar la lista de archivos compartidos.
- IPFilter
- Recargar tablas de filtros IP.
Reset¶
Reiniciar el registro.
Results [<id>]¶
Muestra los resultados de una búsqueda. Opcionalmente, toma un <id> de búsqueda (como obtenido de search); sin id, muestra la última búsqueda iniciada. Se pueden mantener varias búsquedas a la vez en el núcleo y acceder a ellas por el id.
Resume <hash> | <number>¶
Reanuda la descarga especificada por <hash> o <number>. Para obtener el valor use show.
Search <type> [<filters>] <keyword>¶
Hace una búsqueda para la <keyword> especificada. El tipo de búsqueda y una palabra a buscar son obligatorios. Ejemplo: 'search kad amule' realiza una búsqueda kad de la palabra 'amule'. Muestra un id de búsqueda; páselo a results o progress para identificar esta búsqueda. Varias búsquedas se pueden ejecutar a la vez, cada una con su propio id.
Tipos de búsquedas disponibles:
Pueden colocarse filtros opcionales antes, después o intercalados con la(s) palabra(s) clave de búsqueda:
- --type <Audio|Video|Image|Doc|Pro|Arc|Iso>
- Restringe los resultados al tipo de archivo indicado.
- --extension <ext> (alias: --ext)
- Restringe los resultados a una extensión de archivo específica (ej. iso, mp3).
- --avail <N> (alias: --availability)
- Número mínimo de fuentes que un resultado debe informar.
- --min-size <N[KMG]>
- Tamaño mínimo de archivo a devolver. Los sufijos usan multiplicadores binarios (K = 1024, M = K×1024, G = M×1024); sin sufijo significa bytes.
- --max-size <N[KMG]>
- Tamaño máximo de archivo a devolver. Mismos sufijos que --min-size.
Ejemplo: 'search global linux iso --type Iso --min-size 100M' devuelve resultados para 'linux iso' de tipo de archivo Iso de al menos 100 MiB.
Set <what>¶
Asigna un valor dado de opción.
Valores disponibles para <what>:
Show <what>¶
Muestra la cola de subida/descarga, la lista de servidores, o la lista de archivos compartidos.
Valores disponibles para <what>:
Shutdown¶
Apaga el núcleo remoto en ejecución (amule/amuled). Esto también terminará el cliente de texto, ya que es inútil sin un núcleo remoto activo.
Statistics [ <number> ]¶
Mostrar árbol de estadísticas.
Un <number> opcional en el rango 0-255 puede pasarse como parámetro de este comando, que indica cuántos valores de versiones de clientes debe mostrar el árbol. Pasar 0, u omitirlo significa 'ilimitado'.
Ejemplo: 'statistics 5' mostrará sólo las primeras 5 versiones de cada tipo de cliente.
Status¶
Muestra el estado de la conexión, la velocidad de subida/descarga actual, etc.
NOTAS¶
Rutas¶
Todas las opciones que tengan <path> como valor, si path no contiene una ruta de directorios (p.e. sólo un archivo normal), entones se usará el directorio de la configuración, ~/.aMule.
Lenguajes¶
El parámetro <lang> para la opción -l tiene esta forma: lang[_LANG][.encoding][@modifier] donde lang es el lenguaje primario, LANG es un sublenguaje/territorio, encoding es el conjunto de caracteres a usar y modifier permite al usuario elegir una instancia específica de localización dentro de una única categoría.
Por ejemplo, las siguientes cadenas son válidas:
de_DE
de_DE.iso88591
de_DE@euro
de_DE.iso88591@euro
Aunque todas las cadenas previas son aceptadas como definiciones de lenguaje válidas, encoding y modifier aún no se usan.
Además del formato previo, también se pueden especificar el nombre completo del idioma en inglés, por lo que -l german es válido y equivale a -l de_DE.
Cuando no se define ninguna localización, ni por línea de comandos ni en fichero de configuración, se usará el lenguaje por defecto del sistema.
ARCHIVOS¶
~/.aMule/remote.conf
EJEMPLO¶
Normalmente amulecmd se ejecutará primero como:
amulecmd -h hostname -p ECport -P ECpassword -w
o
amulecmd --create-config-from=/home/usuario/.aMule/amule.conf
Esto guardará las opciones en $HOME/.aMule/remote.conf, y después sólo tiene que escribir:
amulecmd
Por supuesto, no tiene por qué seguir este ejemplo.
INFORMANDO ERRORES¶
Por favor informe de fallos ya sea en nuestro foro (https://github.com/amule-org/amule/discussions), o en nuestro bugtracker (https://github.com/amule-org/amule/issues). Por favor no informe de fallos por correo, ni en nuestras listas, ni directamente al correo de algun miembro del equipo.
COPYRIGHT¶
aMule y todas las demás utilidades relacionadas son distribuidas bajo la GNU General Public License.
VÉASE TAMBIÉN¶
AUTOR¶
Esta página de manual fue escrita por Vollstrecker <amule@vollstreckernet.de>
| October 2026 | aMuleCmd v3.1.0 |