maestral
v1.9.4
Un cliente Dropbox de peso ligero y de código abierto para macOS y Linux.
Maestral es un cliente de Dropbox de código abierto escrito en Python. El objetivo principal del proyecto es proporcionar un cliente para plataformas y sistemas de archivos que ya no son compatibles directamente con Dropbox.
Actualmente, Maestral no admite Dropbox Paper, la gestión de los equipos de Dropbox y la gestión de la configuración de la carpeta compartida. Si necesita alguna de esta funcionalidad, utilice el sitio web de Dropbox o el cliente oficial. Maestral admite sincronizar múltiples cuentas de Dropbox y excluir archivos locales de Sync con un archivo ".mignore".
El enfoque en la sincronización de archivos "simple" viene con ventajas: en MacOS, el paquete de aplicaciones de Maestral es significativamente más pequeño que la aplicación oficial de Dropbox y usa menos memoria. El uso exacto de la memoria dependerá del tamaño de su carpeta Dropbox sincronizada y se puede reducir aún más cuando se ejecuta Maestral sin una GUI.
Maestral utiliza la API pública de Dropbox que, a diferencia del cliente oficial, no admite transferir solo aquellas partes de un archivo que cambió ("Diff Binary"). Por lo tanto, Maestral puede usar más ancho de banda que el cliente oficial. Sin embargo, evitará cargar o descargar un archivo si ya existe con el mismo contenido localmente o en la nube.
Se proporciona un paquete de aplicaciones para MacOS Catalina y más alto y se puede descargar desde la pestaña Lanzamientos. Este paquete de aplicaciones también es un paquete como un barril de cerveza casera.
En otras plataformas, puede descargar e instalar Maestral como un paquete Python de Pypi o como una imagen Docker desde Docker Hub.
Para obtener información más detallada sobre los requisitos de instalación, configuración y sistema, consulte la documentación.
Los lanzamientos maestros oficiales también están disponibles como barriles caseros. Si tiene cebro casera en su sistema, puede instalar usando:
$ brew install maestralSe recomienda instalar Maestral dentro de un entorno virtual de la siguiente manera:
$ python3 -m venv maestral-venv
$ source maestral-venv/bin/activate
(maestral-venv)$ python3 -m pip install --upgrade maestral Si tiene la intención de usar la interfaz gráfica de usuario, también debe especificar la opción GUI durante la instalación o actualización. Esto instalará el Frontend y PyQt5 maestral-qt en Linux y maestral-cocoa en MacOS:
(maestral-venv)$ python3 -m pip install --upgrade 'maestral[gui]'Una imagen Docker está disponible para plataformas X86, ARM/V7 (32 bits) y ARM64 y se puede instalar con:
$ docker pull maestraldbx/maestral
Ejecute maestral gui en la línea de comandos (o abra la aplicación Maestral en MacOS) para iniciar Maestral con una interfaz gráfica de usuario. En su primera ejecución, Maestral lo guiará a través de la vinculación y la configuración de su Dropbox y luego comenzará a sincronizar.
Después de la instalación, Maestral estará disponible como un script de línea de comando escribiendo maestral en el símbolo del sistema. Escriba maestral --help para obtener una lista completa de los comandos disponibles. Los más importantes son:
maestral gui : comienza la GUI maestra. Crea un demonio de sincronización si no se está ejecutando.maestral start|stop : comienza o detiene el demonio de sincronización maestra.maestral pause|resume : pausas o currículums sincronizando.maestral autostart -Y|-N : Establece el demonio para comenzar en el inicio de sesión.maestral status : Obtiene el estado actual de Maestral.maestral filestatus LOCAL_PATH : Obtiene el estado de sincronización de un archivo o carpeta individual.maestral excluded add|remove|list : Grupo de comandos para administrar carpetas excluidas.maestral ls DROPBOX_PATH : enumera el contenido de un directorio en Dropbox.maestral notify snooze N : Snoozes Notificaciones de escritorio durante n minutos. Maestral admite sincronizar múltiples cuentas de Dropbox ejecutando múltiples instancias con diferentes archivos de configuración. Esto debe configurarse desde la línea de comando pasando la opción --config-name to maestral start o maestral gui . Maestral seleccionará una configuración existente con el nombre de pila o creará una nueva. Por ejemplo:
$ maestral start --config-name= " personal "
$ maestral start --config-name= " work " Esto comenzará dos instancias de Maestral, sincronizando una cuenta privada y de trabajo, respectivamente. Las configuraciones se borrarán automáticamente al no beber una cuenta. Puede enumerar todas las cuentas vinculadas actualmente con maestral config-files . La configuración anterior, por ejemplo, devolverá lo siguiente en macOS:
$ maestral config-files
Config name Account Path
maestral [email protected] ~/Library/Application Support/maestral/maestral.ini
private [email protected] ~/Library/Application Support/maestral/private.iniDe manera predeterminada, los nombres de la carpeta de Dropbox contendrán el nombre de configuración capitalizado en los aparatos ortopédicos. En el caso anterior, esto será "Dropbox (personal)" y "Dropbox (Work)".
Una documentación completa de la CLI está disponible en el sitio web.
Hay múltiples temas que podrían usar su ayuda. Algunos de ellos son fáciles, como agregar nuevos comandos de CLI, otros requieren más experiencia, como el empaque para plataformas que no son de Macos. Esté atento a los problemas marcados con "buen primer problema" o "ayuda deseada".
Los recursos relevantes son:
Contribuir.MD contiene información detallada sobre el estilo de código esperado y el formato de prueba.
Si está utilizando el paquete de aplicaciones de MacOS, considere patrocinar el proyecto con £ 1 por mes para compensar el costo de una cuenta de desarrollador de Apple para firmar y notarizar el paquete.
