Envoyer un document depuis le Finder, sur Mac

À savoir

Choisir le dossier où atterrissent les documents

Trois façons de répondre à la question, selon que vous voulez décider à chaque fois ou ne plus y penser. Les deux premières se règlent dans le fichier de l'étape 3.

Réglage	Ce qui se passe au clic droit
ARCHIVE_PDF_ASK="1" réglage par défaut	Une liste de vos dossiers s'ouvre, celui de la dernière fois est présélectionné. Le bouton Annuler met fin à l'envoi.
ARCHIVE_PDF_ASK="0" ARCHIVE_PDF_FOLDER="1097"	Aucune question, tout part dans ce dossier. Le numéro est celui que donne archive-pdf-finder --dossiers.
Jeton limité à un dossier	La destination est portée par le jeton, côté serveur. Ce que le Mac demande ou propose n'y change rien, et un jeton dérobé ne peut rien écrire ailleurs.

Archive PDF

Dossier de destination:

Factures

Contrats

Scans du courrier

AnnulerEnvoyer

Deux entrées distinctes dans le clic droit

Pour avoir par exemple Envoyer dans Factures et Envoyer dans Contrats côte à côte, créez deux actions rapides dont le script force la destination, chacune avec son numéro de dossier.

ARCHIVE_PDF_ASK=0 ARCHIVE_PDF_FOLDER=1130 /usr/local/bin/archive-pdf-finder "$@"

Le nom sous lequel vous enregistrez l'action rapide est celui qui apparaît dans le menu: nommez-la comme le dossier.

Savoir que le document est bien arrivé

Le Mac ne rend la main qu'une fois la réponse du serveur reçue. Trois preuves se cumulent, de la plus immédiate à la plus durable.

Preuve	Ce qu'elle vaut
La notification	Elle nomme le document quand il n'y en a qu'un, et les compte quand il y en a plusieurs. Le mode concentration peut la retenir: elle ne suffit donc pas seule.
Le lien dans le presse-papiers	Le lien du document archivé y est copié automatiquement. Il se colle dans un courriel, et il ouvre la fiche du document dans votre archive. C'est la preuve qui ne dépend d'aucun réglage du Mac.
Le journal du jeton	Chaque envoi est enregistré avec sa date, le nom du document et l'adresse IP, dans le tableau d'activité en bas de la page des jetons. C'est là qu'on regarde après coup, ou en cas de doute.

Un document volumineux peut demander plus de temps de traitement que l'envoi lui-même. La notification dit alors archivage en cours au lieu de nommer le document: il est bien reçu et il apparaîtra dans le dossier choisi, mais son lien n'est pas encore disponible.

Si quelque chose ne va pas

Un échec ouvre toujours une fenêtre, jamais une simple notification: un envoi raté ne doit pas pouvoir passer inaperçu. Le message y est donné fichier par fichier.

Message	Ce qu'il faut faire
Aucun jeton configuré	L'étape 3 n'a pas été faite, ou le fichier a été enregistré vide. Rouvrez-le avec archive-pdf-finder --reglages.
Jeton absent, invalide ou révoqué	Le jeton a été révoqué, ou mal collé. Créez-en un neuf sur la page des jetons.
Ce jeton n'autorise pas l'ajout de fichiers	La permission Ajouter n'était pas cochée à la création. Elle ne s'ajoute pas après coup: créez un jeton neuf, révoquez l'ancien.
Dossier de destination invalide, ou aucun dossier choisi	Le dossier a été supprimé, ou le jeton n'est pas limité à un dossier et aucune destination n'a été fournie. Relisez les numéros avec archive-pdf-finder --dossiers.
Ce dossier est en lecture seule	Il s'agit d'un dossier partagé avec vous sans droit de dépôt. Choisissez un dossier qui vous appartient.
Fichier trop volumineux pour votre offre	Cette route accepte 200 Mo par document. Au-delà, passez par l'envoi depuis le portail.
Espace de stockage insuffisant	Le quota du compte est atteint. Rien n'a été écrit.
Le traitement du document a échoué	Le fichier est arrivé mais n'a pas pu être traité, par exemple parce qu'il est endommagé. Ouvrez-le sur le Mac pour vérifier, puis recommencez.
Pas de réseau, ou serveur injoignable	Rien n'a été envoyé. Recommencez une fois la connexion revenue.
Rien ne se passe du tout	Les notifications sont probablement coupées. Vérifiez le presse-papiers: si le lien du document s'y trouve, l'envoi a bien eu lieu. Pour remplacer les notifications par des fenêtres, ajoutez ARCHIVE_PDF_DIALOG="1" au fichier de réglages.

Ce que cette version ne fait pas

Ni description ni mots-clés à l'envoi. Chaque document arrive avec une description automatique portant la date, et le mot-clé api. Le reste se renseigne depuis la fiche du document.

Les dossiers du Mac ne sont pas pris en charge. Une sélection qui en contient est refusée, en nommant le dossier en cause. Sélectionnez les fichiers eux-mêmes.

La notification n'est pas signée Archive PDF. macOS l'attribue à l'application qui exécute le script, donc à Automator. C'est le prix d'une mise en place sans application à installer.

Sur un autre système, ou pour aller plus loin

Le client installé à l'étape 2 n'est pas réservé au Finder: il prend des chemins de fichiers en arguments, donc il s'appelle aussi bien depuis un script, une tâche planifiée ou un dossier surveillé. La page CLI, API et S3 décrit ces trois voies, sur Mac comme sur Linux et Windows.

Le même jeton branche aussi votre archive à un assistant IA compatible MCP, qui peut alors chercher dans vos documents et y déposer les siens: voir l'intégration IA.

Le jeton reste sur votre Mac, en clair

Il vit dans votre dossier personnel, en ~/.config/archive-pdf/config, lisible par votre session. C'est un identifiant de dépôt: il ne donne accès ni à vos documents ni à votre compte, et il se révoque d'un clic depuis la page des jetons. Sur un Mac partagé, donnez-lui un périmètre d'un seul dossier au moment de le créer, avant de le copier dans ce fichier.