{"id":18640184,"url":"https://github.com/scotchman0/exp_gen","last_synced_at":"2026-04-14T04:31:59.758Z","repository":{"id":111092071,"uuid":"377201533","full_name":"Scotchman0/exp_gen","owner":"Scotchman0","description":"A lightweight local CLI experience generator and level-up system! (Just for fun). Give yourself rewards for doing jobs in the form of a exp gain!","archived":false,"fork":false,"pushed_at":"2021-08-26T19:52:00.000Z","size":39,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-13T15:51:52.681Z","etag":null,"topics":["bash","cli","exp","experience","gamification","levelup","linux","mac","timer","tools","work-time","work-tracker"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Scotchman0.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-15T14:59:22.000Z","updated_at":"2021-08-26T19:52:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"8f036576-8560-4916-bc36-48038be09af2","html_url":"https://github.com/Scotchman0/exp_gen","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Scotchman0/exp_gen","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scotchman0%2Fexp_gen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scotchman0%2Fexp_gen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scotchman0%2Fexp_gen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scotchman0%2Fexp_gen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Scotchman0","download_url":"https://codeload.github.com/Scotchman0/exp_gen/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scotchman0%2Fexp_gen/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31782736,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T02:24:21.117Z","status":"ssl_error","status_checked_at":"2026-04-14T02:24:20.627Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["bash","cli","exp","experience","gamification","levelup","linux","mac","timer","tools","work-time","work-tracker"],"created_at":"2024-11-07T05:53:38.212Z","updated_at":"2026-04-14T04:31:59.528Z","avatar_url":"https://github.com/Scotchman0.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EXP_GEN: Experience Generator/tracker\n\nThis system is designed to help you \"gamify\" your projects and tasks into achievable EXP gains.\n\nEXP does nothing and the points don't matter, but it sure does feel good to earn. \n\nLeveling up: Results in a positive reinforcement message echoed to console + reward message generally in the form of \"Take a break, you earned it!\" Designed to entice you to work until you hit a level up, and then take a break doing something you want to do. \n\n# Installation:\n1. clone this repository to a local directory in your system:\n\n\u003e git clone https://github.com/scotchman0/exp_gen.git\n\n2. cd into the cloned directory and make a symlink to your home/username/bin folder:\n\n\u003e$ mkdir ~/bin\n\n\u003e$ ln -s /home/username/path/to/exp_gen/exp ~/bin/exp\n\nbecause ~/bin is part of your $PATH variable by default (if it isn't see below) it should become executable automatically when you call 'exp' in the command line. \n\n3. run exp once to generate the level_up files to get an overview of the syntax/usage, or get started with the below command options: $ exp (status|add|timer|timeloop) [e]  --\u003e e=experience to gain\n\n\u003e $ exp help\n===========================================================================================\n# Earning EXP:\nThere are several ways to earn EXP:\n\n1. exp command line manual addition:\n$ exp add [e]\nusing the exp add command and including a value [e] will add or subtract that much EXP from your running total.\nJust finished a git commit/finished a chapter/completed a workout?\n\n\u003e $ exp add 5\n\u003e \n\u003e earned '5' exp!\n\n\n2. Tracking a task via timer. (work for n minutes and earn EXP gain either repeatedly every n or at end of timer)\ncommand options: timer or timeloop:\n\n\u003e $ exp timer 5\n\u003e \n\u003e wait how long before gaining '5' exp? (in minutes - whole integers only)\n\u003e \n\u003e 10\n\u003e \n\u003e now waiting for '600' seconds, press ctrl+c to cancel\n\u003e \n\u003e ...[after waiting 600 seconds]...\n\u003e \n\u003e earned '5' exp!\n\n\n\u003e $ exp timeloop 5\n\u003e \n\u003e wait how long before gaining '5' exp? (in minutes - whole integers only)\n\u003e \n\u003e this will loop forever until manually stopped with ctrl+c - good for study blocks\n\u003e \n\u003e $ 5\n\u003e \n\u003e now waiting for '300' seconds, press ctrl+c to cancel\n\u003e \n\u003e earned '5' exp!\n\u003e \n\u003e now waiting for '300' seconds, press ctrl+c to cancel\n\u003e \n\u003e earned '5' exp!\n\u003e \n\u003e ...\n\n# Check your level/exp gain:\n\n\u003e exp status\n\n![exp status](https://user-images.githubusercontent.com/35974491/122405010-aefa4200-cf4d-11eb-9843-ae4bf00b7254.png)\n\n\n# Leveling: \n\n![level_up](https://user-images.githubusercontent.com/35974491/122405235-e0730d80-cf4d-11eb-86a6-28327fff3eb5.png)\n\n\nLeveling occurs on a growth scale, so earning EXP goes further in the beginning than in the late game, but I also recognize that sometimes you just want to earn EXP and level up like crazy sometimes so there's a few ways that this will work. You can also always go in and set the level caps yourself, just modify ~/.exp_gen/exp_gen.conf and add the line: level_CAP=50 (or whatever modified lower/higher static value you wish to have set). To reset back to normal mode just run $ exp normal_mode and it'll undo your changes.\n\nEasy mode:\nadjusts all the level caps to 50XP\n\nrun:\n\u003e $ exp easy_mode \n\n\u003e $ exp normal_mode   #to return to regular exp gain, shown below (this is already enabled by default)\n\n\nYou may modify these values all you want in the exp file. \n\n\nLevel \t\t\t\tEXP needed\n\n0-10\t\t|\t\t  100\n\n11-20\t\t|\t\t  110\n\n21-30\t\t|\t\t  125\n\n31-40\t\t|\t\t  150\n\n41-50\t\t|\t\t  175\n\n51-60\t\t|\t\t  200\n\n61-70\t\t|\t\t  225\n\n71-80\t\t|\t\t  250\n\n81-90\t\t|\t\t  275\n\n91-100\t|\t\t\t300\n\n101-150\t|\t\t\t325\n\n151-200\t\t|\t\t350\n\n201-250\t\t|\t\t375\n\n251-300\t\t\t|\t400\n\n301-400\t\t|\t\t425\n\n401-500\t\t|\t\t450\n\n501-600\t\t|\t\t475\n\n601-10000\t\t|\t500 #if you're up here I'll be amazed.\n\n\n----------------------------------------\n\n# other commands:\nUninstall:\n\n\u003e exp uninstall_exp #removes all contents in ~/.exp_gen/* (which were generated on first time exp launch)\n\n(don't forget to delete your symlink in ~/bin or else when you call exp again it'll put these files back).\n\nGet help with commands:\n\n\u003e exp help\n\nTo reset all your progress/levels back to zero - run:\n\n\u003e $ exp reset_progress\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscotchman0%2Fexp_gen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscotchman0%2Fexp_gen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscotchman0%2Fexp_gen/lists"}