https://github.com/t-markmann/nc-userimporter

This tool creates Nextcloud users from a CSV file, which you exported from some other software or created with a spreadsheet software.
https://github.com/t-markmann/nc-userimporter

Last synced: about 1 month ago
JSON representation

This tool creates Nextcloud users from a CSV file, which you exported from some other software or created with a spreadsheet software.

• Host: GitHub
• URL: https://github.com/t-markmann/nc-userimporter
• Owner: t-markmann
• License: gpl-3.0
• Created: 2019-04-28T12:38:48.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-06-17T23:32:30.000Z (3 months ago)
• Last Synced: 2024-06-21T12:27:37.412Z (3 months ago)
• Language: Python
• Homepage:
• Size: 22.3 MB
• Stars: 59
• Watchers: 4
• Forks: 20
• Open Issues: 19
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred - t-markmann/nc-userimporter - This tool creates Nextcloud users from a CSV file, which you exported from some other software or created with a spreadsheet software. (others)

README

        
# About nc-userimporter

This tool creates Nextcloud users from a CSV file, which you exported from some other software or created with a spreadsheet software.

Zip file with an executable for Windows is available here: https://get.edudocs.org/de/assets/nc-userimporter/ - If you have a Python3 environment with all the dependencies/modules installed, you can run the script without the build of course.

Screenshot input:

![Screenshot from Windows commandline](https://github.com/t-markmann/nc-userimporter/blob/master/assets/screenshot.png)

## Instructions

1. Download and extract the zip-file from https://get.edudocs.org/de/assets/nc-userimporter/

2. Insert data:

    * __config.xml__: Insert your cloud-admin credentials into file _config.xml_. The user must have admin permissions in your Nextcloud.

    * __users.csv__: Insert the user data into the file _users.csv_ or recreate it with the same columns in a spreadsheet software.

3. Start the tool:

    * __Windows__: doubleclick _nc-userimporter.exe_.

    * __Linux__ / __Mac__: install all dependencies (https://github.com/t-markmann/nc-userimporter/wiki#install-dependencies-for-running-py-script) and run: python3 nc-userimporter.py

    	* __Troubleshooting__: Make sure the file is executable (https://www.qwant.com/?q=make%20file%20executable%20linux / https://www.qwant.com/?q=make%20file%20executable%20mac)

4. Follow the interactive commandline instructions. Check output.log ("output"-folder in script-directory) and your user overview in Nextcloud.

## Output

Screenshot output:

![Generated PDF file with user credentials](https://github.com/t-markmann/nc-userimporter/blob/master/assets/screenshot_pdfoutput.png)

---

## ToDo

* improve documentation of features https://github.com/t-markmann/nc-userimporter/wiki#todo-documentation

* refactoring / clean code

Open features, not yet implemented (help appreciated): 

* read config from CLI-input if config-file is empty; update config.xml with input values?

* ask if users exists first: https://docs.nextcloud.com/server/15/admin_manual/configuration_user/instruction_set_for_users.html

* add other userdata

* delete users