ArchiveBoxExtensions de navigateur

🗃 Extension de navigateur ArchiveBox

Cette extension envoie des onglets ou des URL correspondant à certains motifs vers votre instance ArchiveBox pour les conserver hors ligne. Elle offre plusieurs avantages :

Obtenir l’extension

Captures d’écran

Voir toutes les captures →

Chrome Web Store — desktopFirefox Add-ons — desktopSave the current page — desktopChoose crawl depth — desktopSaved URLs — desktopExport saved URLs and captures — desktopEdit tags — desktopConfiguration — desktopArchiving profile and imported browser cookies — desktopImport browser bookmarks — desktopImport browser history — desktopRead a saved MHTML snapshot — desktopView a saved screenshot — desktop

Fonctionnalités

Importer depuis Safari

Safari ne fournit pas d’accès en masse aux favoris ou à l’historique via ses API WebExtension. Utilisez l’option Apple exportation des données de navigation: sur Mac, choisissez Fichier → Exporter les données de navigation vers un fichier; sur iPhone/iPad, choisissez Settings → Applications → Safari → Export. Sélectionnez les favoris, la liste de lecture et l’historique disponibles.

Dans Options de l’extension → Importer des URL en masse, choisissez les données Safari à importer et la période de l’historique, puis sélectionnez le ZIP exporté (ou les fichiers HTML/JSON extraits). Vérifiez les URL, sélectionnez celles à conserver et cliquez sur Importer la sélection. Les URL déjà enregistrées sont signalées comme doublons. L’historique conserve l’heure de visite d’origine. Les fichiers sont analysés localement, les mots de passe et les cartes de paiement sont ignorés, et les importations rejoignent la même liste d’URL enregistrées que les autres sources d’importation. Utilisez les actions de synchronisation existantes pour les envoyer au serveur.

Captures locales

Lorsque l’enregistrement local des captures est activé dans les options, l’extension stocke les fichiers capturés dans le stockage OPFS local à l’extension avant d’afficher la fenêtre contextuelle :

Les copies locales dans OPFS sont supprimées après 30 jours par défaut ; vous pouvez configurer l’extension pour les conserver indéfiniment ou les supprimer dès que le serveur reçoit l’URL.

Configuration

  1. Configurez un ArchiveBox et vérifiez qu’il est accessible depuis l’appareil sur lequel vous naviguez
  2. Dans ArchiveBox 0.9.0, ouvrez Administration → API → Clés API → Créer une clé API, créez une clé et copiez-la.
  3. Ouvrez Options de l’extension → Configuration, collez la clé dans Clé API, puis saisissez l’URL de votre serveur ArchiveBox (par exemple https://archivebox.example.com) dans URL du serveur. Enregistrez la configuration et testez la connexion. Extension configuration
  4. ✅ Essayez-la en faisant un clic droit sur une page et en sélectionnant Save to ArchiveBox, ou en cliquant sur l’icône de l’extension dans la barre des menus. ArchiveBox popup

Développement

✨ Contribution originale de TJ Horner (@tjhorner), désormais maintenue par @benmuth et le ArchiveBox équipe.

Pour contribuer à cette extension (ou simplement la compiler pour vous-même), vous devrez télécharger et installer Node.js et pnpm.

git clone https://github.com/ArchiveBox/archivebox-browser-extension
cd archivebox-browser-extension/

pnpm install
pnpm compile
pnpm build
pnpm build:edge
pnpm build:firefox
pnpm build:safari

Pour le développement local :

pnpm dev           # Chrome / Chromium
pnpm dev:edge      # Edge
pnpm dev:firefox   # Firefox
pnpm dev:safari    # Safari WebExtension build

Pour une compilation locale de type production, chargez .output/chrome-mv3 dans Chrome / Chromium avec Charger l’extension non empaquetée interface, chargez .output/edge-mv3 dans Edge avec edge://extensions, chargez .output/firefox-mv3 dans Firefox avec about:debugging, ou chargez .output/safari-mv3 dans Safari via Réglages → Développeur → Ajouter une extension temporaire.

Pour vérifier la conservation locale avec de vraies réponses du serveur et l’horloge réelle d’une minute, démarrez un serveur ArchiveBox jetable sans workers d’archivage (afin de garder les envois en attente), compilez l’extension et exécutez :

ARCHIVEBOX_TEST_SERVER=http://127.0.0.1:5797 \
ARCHIVEBOX_TEST_KEY_FILE=/path/to/disposable-server-api-key \
node scripts/test-retention-live.mjs

Le test réel importe des favoris via l’interface des options, les envoie, vérifie leur conservation en cas de déconnexion ou d’absence du serveur, contrôle la suppression d’OPFS et des métadonnées, redémarre le service worker et attend l’expiration automatique après un nouvel envoi. Il crée des enregistrements de test sur le serveur et supprime l’un des siens pour tester une capture absente ; utilisez une collection jetable. Les vérifications des valeurs par défaut, de la persistance et de la disposition de l’interface s’exécutent avec pnpm exec playwright test tests/retention.test.ts tests/options-responsive.test.ts.

Historique des versions

Autres extensions d’archivage

D’autres extensions de navigateur archivent également le web et pourraient mieux répondre à vos besoins si ArchiveBox ne vous convient pas.

Autres projets d’aide ArchiveBox

D’autres projets facilitant l’importation d’URL dans ArchiveBox depuis diverses sources.

Licence

MIT Licence