Scroll to navigation

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:

  • un enlace de archivo (ed2k://|archivo|...), será añadido a la cola de descarga;
  • un enlace de servidor (ed2k://|servidor|...), será añadido a la cola de servidores;
  • un enlace con una lista de servidores, se añadirán todos los servidores a la lista.

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>:

Obtener los límites de ancho de banda.
Obtener opciones del filtro IP.

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>:

Prioridad automática.
Prioridad alta.
Prioridad baja.
Prioridad normal.

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.
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:

Realiza una búsqueda global.
Realiza una búsqueda en la red Kademlia.
Realiza una búsqueda local.

Pueden colocarse filtros opcionales antes, después o intercalados con la(s) palabra(s) clave de búsqueda:

Restringe los resultados al tipo de archivo indicado.
Restringe los resultados a una extensión de archivo específica (ej. iso, mp3).
Número mínimo de fuentes que un resultado debe informar.
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.
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>:

Establecer los límites de ancho de banda.
Ajusta las opciones del FiltroIP.

Show <what>

Muestra la cola de subida/descarga, la lista de servidores, o la lista de archivos compartidos.

Valores disponibles para <what>:

Mostrar la cola de descarga.
Mostrar el registro.
Mostrar la lista de servidores.
Mostrar la lista de archivos compartidos.
Mostrar la cola de subida.

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_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

amule(1), amuled(1)

AUTOR

Esta página de manual fue escrita por Vollstrecker <amule@vollstreckernet.de>

October 2026 aMuleCmd v3.1.0