{"id":25726752,"url":"https://github.com/weibeu/dueutil","last_synced_at":"2026-04-16T05:33:05.935Z","repository":{"id":53617645,"uuid":"117414766","full_name":"weibeu/DueUtil","owner":"weibeu","description":"Modified DueUtil bot ready to setup on heroku. Easy setup","archived":false,"fork":false,"pushed_at":"2021-03-20T13:53:28.000Z","size":57778,"stargazers_count":1,"open_issues_count":1,"forks_count":3,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-04-25T14:59:11.233Z","etag":null,"topics":["bot","database","discord","discord-bot","dueutil","heroku","mongodb","quest"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/weibeu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null}},"created_at":"2018-01-14T08:36:03.000Z","updated_at":"2022-03-31T19:31:58.000Z","dependencies_parsed_at":"2022-08-25T18:42:05.044Z","dependency_job_id":null,"html_url":"https://github.com/weibeu/DueUtil","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/weibeu/DueUtil","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weibeu%2FDueUtil","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weibeu%2FDueUtil/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weibeu%2FDueUtil/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weibeu%2FDueUtil/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/weibeu","download_url":"https://codeload.github.com/weibeu/DueUtil/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weibeu%2FDueUtil/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31872621,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"online","status_checked_at":"2026-04-16T02:00:06.042Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","database","discord","discord-bot","dueutil","heroku","mongodb","quest"],"created_at":"2025-02-25T23:18:42.429Z","updated_at":"2026-04-16T05:33:05.915Z","avatar_url":"https://github.com/weibeu.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DueUtil\n### The questing and fun discord bot ready to setup on heroku with mongodb connection, without installing mongodb element on heroku\n\n#### Running the bot\n(more detailed setup / install script later -- maybe)\n\nRequirements:\n* Python 3.5 +\n* The packages in requirements.txt (`pip install -r requirements.txt`)\n* MongoDB  (https://docs.mongodb.com/manual/installation/)\n* PHP \u0026 Apache (if you really want to run the site too)\n\n##### Setup the DB\n1. Create an account that can create \u0026 update databases (admin will do)\n2. Put the account details in `dbconfig.json`\n\n```json\n{\n    \"url\" : \"your mongodb app authentication url (v 4)\"\n}\n```\nsignup at mongodb website, create cluster and get app authentication url\n\n##### Configure DueUtil\nCreate a file `dueutil.json` in the same folder as `run.py` (the root).\n```json\n{\n   \"botToken\":\"[DISCORD BOT TOKEN]\",\n   \"owner\":\"[OWNER DISCORD ID]\",\n   \"shardCount\":1,\n   \"shardNames\":[\n      \"Clone DueUtil: shard 1\"\n   ],\n   \"logChannel\": \"[SERVER ID]/[CHANNEL ID]\",\n   \"errorChannel\": \"[SERVER ID]/[CHANNEL ID]\",\n   \"feedbackChannel\": \"[SERVER ID]/[CHANNEL ID]\",\n   \"bugChannel\": \"[SERVER ID]/[CHANNEL ID]\",\n   \"announcementsChannel\":\"[SERVER ID]/[CHANNEL ID]\",\n   \"carbonKey\":\"[https://www.carbonitex.net key you won't have]\",\n   \"discordBotsOrgKey\":\"https://discordbots.org/ key you also won't have\",\n   \"discordBotsKey\": \"https://bots.discord.pw/ key you also also won't have\",\n   \"discoinKey\":\"http://discoin.sidetrip.xyz/ you will never get\",\n   \"sentryAuth\": \"[SENTRY AUTH]\"\n}\n```\nThe logging channels are currenly needed (the bot may not work properly without them), the bot probably can run without the other keys.\n\n##### Restoring the database\n\n1. Download the database dump from the last release\n2. Extract that zip into folder called `database`\n    ```\n    database\n    `-- dueutil\n        |-- award_stats.bson\n        |-- award_stats.metadata.json\n        |-- _CacheStats.bson\n        ...\n    ```\n    Your file tree should look like this\n 3. Use mongorestore\n    ``mongorestore  --username your_use --password \"your_pass\" --authenticationDatabase admin ./database``\n\n##### Setup on heroku!\n\ngoto heroku, sign up and create app. IThen goto settings, reveal config vars and add following:\n```\n    MONGOHQ_URL : [your mongo db authentication url]\n    SENTRY_DSN : [your sentry dsn]\n    TOKEN : [your discord bot token]\n```\nDownload and install heroku CLI\nYou may clone this repo or download it to your local system.\nIf you clone repo:\n    Just setup config files in your repo, goto heroku, link your github, and deploy your app from heroku.\n    Click on deploy branch in deploy tab\n    Login to you heroku CLI, `heroku login`\n    Enter `heroku ps:scale worker=1 -a [your app name on heroku]` to finally start your app\n    You may use `heroku logs -t -a [your app name on heroku]` to view heroku logs and python logs.\nIf you downloaded zip:\n    Extract zip to folder, then open `quest-knight` (app root directory)\n    Open console/cmd here and enter following:\n    ```\n        git init\n        heroku git:remote -a [your app name]\n        git add .\n        git commit -am \"initial commit\"\n        git push heroku master\n    ```\n    To finally start, enter: `heroku ps:scale worker=1`\n    You may use `heroku logs -t -a [your app name on heroku]` to view heroku logs and python logs.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweibeu%2Fdueutil","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fweibeu%2Fdueutil","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweibeu%2Fdueutil/lists"}