PLEASE NOTE that due to an upstream bug the contacts migration is currently broken for any pods running 0.5.x or above code.
Some tools relating to the diaspora* social network (https://github.com/diaspora/diaspora).
Currently supported features:
- Contact migration from pod to pod
Since this is the only supported action, it is also the default at the moment and thus no special command needs to be given.
A "done" user cache file
.diaspora-tools-migrate-user-cache will be
created in working directory where script is executed. If this
file exists, user guids there will not be added to any aspects.
User cache file can be ignored by passing in
--full as a parameter.
- -h, --help show this help message and exit
- -n Don't do any changes, just print out
- --full Sync all users in all aspects, ignore user cache file
- --wait Wait for webfinger lookups to resolve
For example, to migrate contacts from pod A to pod B, waiting for any triggers that happen to other pods (increases script run time), the following command would do the trick:
python diaspora-tools.py --wait jack:password1234@https://pod.example.com jack:password1234@https://pod.foobar.com
You can specify the
-n option to just try out the script without actually making any changes.
How are contacts added?
Each aspect is read from the source pod and these contacts will be added (if they can be found!) to the same aspect on the target pod. If that aspect is missing, the aspect is created.
Are any changes made on the source pod?
No, none at all. Though I take no responsibility for any loss of data :P
Will contacts be notified that my sourcepod acccount has added them?
Yes, in the same way as if added via the Diaspora* web interface.
- Python 2.7. Possibly works with Python 3.x but I have not tested it.
Required Python modules:
For Python 2.x SNI SSL support;
All requirements can be installed using
pip install -r requirements/requirements.txt
Currently only source tarball is available. Download it from the releases and extract to your location of choice.
Install requirements (see above).
No need to (and no benefit in) install diaspora-tools, just run it from the folder it is extracted to.
See other authors from GitHub.
Licensed under the MIT license. No responsibility taken by author about anything this script does or doesn't do :)