{"id":24541444,"url":"https://github.com/HACKER097/wisdom-tree","last_synced_at":"2025-10-03T17:30:53.058Z","repository":{"id":41255744,"uuid":"368917683","full_name":"HACKER097/wisdom-tree","owner":"HACKER097","description":"Wisdom Tree is a TUI concentration app, with features like pomodoro timer, YouTube music player, Lo-fi radio.","archived":false,"fork":false,"pushed_at":"2024-01-04T12:34:13.000Z","size":5246,"stargazers_count":360,"open_issues_count":7,"forks_count":22,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-12-28T15:06:49.741Z","etag":null,"topics":["cli","concentration","music","pomodoro","pomodoro-technique","pomodoro-timer","python","tui","youtube"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HACKER097.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":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-05-19T15:32:50.000Z","updated_at":"2024-12-10T08:26:42.000Z","dependencies_parsed_at":"2024-01-04T13:39:07.653Z","dependency_job_id":"42080663-2d01-4841-86bd-4b2f5ac18510","html_url":"https://github.com/HACKER097/wisdom-tree","commit_stats":{"total_commits":171,"total_committers":7,"mean_commits":"24.428571428571427","dds":0.1578947368421053,"last_synced_commit":"133ea90271a98f3861671cb8412fe4eb06324d63"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HACKER097%2Fwisdom-tree","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HACKER097%2Fwisdom-tree/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HACKER097%2Fwisdom-tree/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HACKER097%2Fwisdom-tree/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HACKER097","download_url":"https://codeload.github.com/HACKER097/wisdom-tree/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235161542,"owners_count":18945540,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cli","concentration","music","pomodoro","pomodoro-technique","pomodoro-timer","python","tui","youtube"],"created_at":"2025-01-22T18:17:42.949Z","updated_at":"2025-10-03T17:30:53.053Z","avatar_url":"https://github.com/HACKER097.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\u003ch3 align=\"center\"\u003e\u003cimg src=\"logo.png\" alt=\"wisdom-tree\"\u003e\u003cbr\u003eWisdom Tree\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n\n[![Downloads](https://pepy.tech/badge/wisdom-tree)](https://pepy.tech/project/wisdom-tree)\n[![Downloads](https://pepy.tech/badge/wisdom-tree/month)](https://pepy.tech/project/wisdom-tree)\n[![Downloads](https://pepy.tech/badge/wisdom-tree/week)](https://pepy.tech/project/wisdom-tree)\n\n\u003c/p\u003e\n\nWisdom Tree is a tui concentration app. Inspired by the wisdom tree in Plants vs. Zombies which gives in-game tips when it grows, Wisdom Tree gives you real life tips when it grows. How can you grow the tree? by concentrating!\n\n# Showcase\nhttps://user-images.githubusercontent.com/38581702/235925233-1abe0e76-da53-41a7-9219-48686aab879c.mp4\n\n\n# Screenshots\n![alt text](https://imgur.com/nFw46EN.png)\n![alt text](https://imgur.com/Q1rGccM.png)\n![alt text](https://imgur.com/VvRaLYd.png)\n![alt text](https://imgur.com/MJCkdMb.png)\n\n\n# Installation\n\nWisdom-tree uses vlc to play music, please make sure vlc is installed. \n\nExtra step for mac `brew install sdl2_mixer`\n\nExtra step for Windows `pip install windows-curses` or `pipx inject wisdom-tree windows-curses`\n\n## Installation from PyPi\n`pip install wisdom-tree` or `pip3 install wisdom-tree`\n\n## Installation using [pipx](https://pypa.github.io/pipx/)\n`pipx install wisdom-tree`\n\nThis allows you to run the app from anywhere\n\n## Installation From Github\n`git clone https://github.com/HACKER097/wisdom-tree`\n\n`cd wisdom-tree`\n\n`pip install -r requirements.txt`\nor\n`pip3 install -r requirements.txt`\n\n\n\n## Running the app\n\n\n- From anywhere after installation from PyPi or using pipx\n\n`wisdom-tree`\n\n- From the github repository (root):\n\n`python3 wisdom_tree/main.py`\n\n*note the underscore*\n\nor\n\n`wisdom-tree`\n\n\n# Usage\n\nUse `left` and `right` arrow keys to change music\n\nTo add your own music, place it inside the `res/` directory (all music must be in `.ogg` format)\n\nUse `up` an `down` arrow keys an `enter` to select and start Pomodoro timers.\n\nWhile using lofi-radio use `n` to skip song and `r` to replay\n\n`[` and `]` to increase and decrease the music/ambience volume respectively\n\n`{` and `}` to increase and decrease the sound effect volume respectively\n\n*You can replace arrow keys with vim's navigation keys (hjkl)*\n\n`m` to mute music.\n\n`r` to toggle repeat.\n\n`u` to toggle q[u]iet mode, which mutes growth sounds and timer start sounds.\n\n`space` to pause and unpause.\n\n`+`, `-` to seek 10 sec forwards and backwords\n\nnumber keys `0-9` to go 0-90% into the audio. Eg; pressing 6 will take you 60% into the audio, 7 will take you 70% and so on.\n\nTo exit press `q`\n\n## Custom quotes\n\nThe user can use any set of quotes by adding a file called `qts.txt` with\none qoute per line to the default config location:\n\n{`CONFIG_LOCATION`}/wisdom-tree\n\nwhere {`CONFIG_LOCATION`} is the default place to save configuration files\nfor the operating system:\n\n- windows: The folder pointed to by `LOCALAPPDATA` or `APPDATA`\n- mac/linux: The folder pointed to by `XDG_CONFIG_HOME` or `~/.config`\n\n*for now, adding a custom quotes file disables the default quotes*\n\n\n# Features\n\nWisdom tree plays a variety of music, environmental sounds and white noises to help you concentrate. You can also import your own music into Wisdom Tree.\n\n3000+ quotes and lines of wisdom. You are assured that you will never see the same quote again\n\nMinimal interface and navigation to increase concentration.\n\nPomodoro timer\n\nPlay music from youtube\n\nLo-Fi radio\n\n# Upcoming Features\n\n~~Play music from youtube~~\n\n~~Lo-Fi radio~~\n\nIf you would like to see a feature implemented, please open an issue with tag [FEATURE REQUEST]\n\n# Tipping \n\nBefore you consider donating, please note that I am still a school student and code in my free time, donating **will not** help me work on wisdom-tree or my other projects faster. Your tip can end up on onlycoins at worst, or pay for my college tuition at best.\n\n\n\nMonero:- \n\n`42hk7SW7mdM5JXYRLAaiD47bqchNGfXJ8aQGhuQJuF9cTBhC5w94aUEcxt7NfokV2URy78RgSXdbiUGYCQZsPFjqDfi7Lto`\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHACKER097%2Fwisdom-tree","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FHACKER097%2Fwisdom-tree","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHACKER097%2Fwisdom-tree/lists"}