FavMasToKey

Documentation d'utilisation

Retour à l'application

Guide étape par étape

1. Préparation

1.1 Obtenir vos favoris depuis Mastodon

  1. Connectez-vous à votre compte Mastodon
  2. Allez dans Préférences > Exporter et importer
  3. Dans la section Exporter, cliquez sur Demander vos favoris
  4. Une fois le fichier prêt, téléchargez-le

1.2 Préparer votre compte Misskey

  1. Assurez-vous d'être connecté à votre compte Misskey
  2. Vérifiez que vous avez suffisamment d'espace pour de nouveaux favoris

2. Utilisation de FavMasToKey

2.1 Télécharger le fichier JSON

  1. Sur la page d'accueil de FavMasToKey, cliquez sur "Parcourir" pour sélectionner votre fichier JSON de favoris
  2. Cliquez sur "Analyser le fichier" pour continuer

2.2 Connexion à votre compte Misskey

  1. Entrez l'URL de votre instance Misskey (ex: misskey.io)
  2. Générez un jeton d'accès depuis les paramètres de votre compte Misskey:
    1. Connectez-vous à votre compte Misskey
    2. Allez dans Paramètres > API
    3. Cliquez sur Générer un nouveau jeton d'accès
    4. Donnez un nom à votre jeton (ex: "FavMasToKey")
    5. Accordez les permissions suivantes :
      • Afficher les informations du compte
      • Afficher les favoris
      • Gérer les favoris
    6. Cliquez sur Générer et copiez le jeton
  3. Collez le jeton d'accès dans le champ correspondant
  4. Cliquez sur "Se connecter à Misskey" pour continuer

2.3 Migration des favoris

  1. Une fois l'autorisation accordée, vous serez redirigé vers l'écran de migration
  2. Cliquez sur "Démarrer la migration" pour commencer le processus
  3. Vous pouvez mettre en pause, reprendre ou annuler la migration à tout moment
  4. Le journal des opérations vous montre l'état de chaque favori traité

3. Résolution des problèmes courants

3.1 Publications non trouvées

Certaines publications peuvent ne pas être trouvées sur le réseau fédéré pour diverses raisons :

  • La publication a été supprimée
  • L'instance d'origine est hors ligne
  • L'utilisateur a changé ses paramètres de confidentialité
  • Votre instance Misskey ne s'est jamais fédérée avec l'instance d'origine

Solution : Malheureusement, il n'y a pas de solution simple pour ce problème, car il s'agit d'une limitation du réseau fédéré. Vous pouvez essayer de visiter manuellement les URLs qui ont échoué.

3.2 Erreurs d'authentification

Si vous rencontrez des problèmes avec votre jeton d'accès :

  • Vérifiez que vous avez copié le jeton entier et sans espaces supplémentaires
  • Assurez-vous d'avoir sélectionné les permissions correctes lors de la génération du jeton
  • Essayez de générer un nouveau jeton d'accès
  • Vérifiez que votre instance Misskey est accessible et fonctionne correctement

3.3 Migration interrompue

Si votre migration est interrompue (par exemple, en fermant l'onglet ou en perdant la connexion Internet), FavMasToKey peut la reprendre :

  • Retournez simplement sur la page de FavMasToKey
  • Authentifiez-vous à nouveau si nécessaire
  • L'application détectera automatiquement la migration en cours
  • Confirmez que vous souhaitez reprendre là où vous vous êtes arrêté

Informations techniques

Comment ça marche ?

FavMasToKey fonctionne en suivant ces étapes :

  1. Analyse du fichier JSON - L'application extrait les URLs des favoris depuis votre fichier Mastodon
  2. Authentification par jeton - L'application utilise le jeton d'accès que vous avez généré pour s'authentifier auprès de votre instance Misskey
  3. Recherche fédérée - Pour chaque favori, l'application recherche la publication équivalente sur le réseau fédéré
  4. Ajout aux favoris - Si la publication est trouvée, elle est ajoutée à vos favoris Misskey

Confidentialité et sécurité

FavMasToKey a été conçu en mettant l'accent sur la confidentialité et la sécurité :

  • Aucune donnée n'est stockée sur le serveur, tout est traité localement dans votre navigateur
  • Les jetons d'accès sont temporaires et ne sont stockés que pendant la durée de votre session
  • Le code est open source et peut être audité
  • L'application ne demande que les permissions minimales nécessaires (ajouter aux favoris)

Limitations connues

  • Les publications qui n'existent plus ou qui sont privées ne peuvent pas être retrouvées
  • Les instances Misskey peuvent avoir des limites de taux (rate limits) qui ralentissent le processus
  • Les grandes collections de favoris peuvent prendre du temps à migrer