CSV Batch Upload¶
Example command line:
scriptabit --run csv_tasks --csv-file [my_csv_file]
Or using the csv-specific command:
sb-csv --csv-file [my_csv_file]
The csv-tasks plugin provides limited support for batch creation of Habitica tasks from a CSV file. The supported task features are:
- Create habits, dailies, todos, or rewards.
- task names
- task extra text
- difficulty level (trivial, easy, medium, or hard)
- character attribute (for attribute-based automatic levelling)
- tags
- for habits, the up and down scoring buttons can be specified.
- for rewards, the reward value can be specified.
Habitica task features that are not currently supported are:
- Due dates
- Checklists
- Repeat options (days of the week, every X days) for Dailies.
The CSV file must have a first row header, with the following columns:
- name (required): Values are used for the task name.
- type (required): Values must be either habit, daily, or todo.
- description (optional): Values used as the extra notes.
- difficulty (optional): The task difficulty. Values should be one of trivial, easy, medium, or hard.
- attribute (optional): Values should be one of strength, intelligence, constitution, or perception.
- tags (optional): Values should be a comma-separated list of tag names for each task. Leave the entry blank if you don’t want tags applied to a task.
- up (optional): This value is only used for habits. Any text at all here means the habit will have an up button.
- down (optional): This value is only used for habits. Any text at all here means the habit will have an down button.
- value (optional): Only used for rewards. Must be an integer value that is greater than zero. Used to set the value of the custom reward.