Get a beautifully formatted minimalistic new tab page with a greeting, date and time, inspirational quotes, your personal tasks and to-do list everytime you open the terminal with Please CLI.
- 🚀 Installation
- 🚑 Troubleshooting
- 👨💻 Commands
- 🧰 Additional Optional Configuration
- 🚮 Uninstalling
- ❤ Credits
-
Make sure you have Python 3 installed on your computer.
-
Open your terminal and paste the command below:
pip install please-cli # If you get an error about 'pip not found', just replace pip with pip3.
-
To run please everytime you open the terminal:
# FOR BASH echo 'please' >> ~/.bashrc # FOR ZSH echo 'please' >> ~/.zshrc
-
That's it! Check if
please
command works in your terminal.
-
Go to the releases section.
-
Download the latest release WHL file.
-
Open terminal and paste the command below:
pip install --user ~/Downloads/please_cli* # If you get an error about 'pip not found', just replace pip with pip3.
Change the path of the file if you downloaded it elsewhere.
-
To run please everytime you open the terminal:
# FOR BASH echo 'please' >> ~/.bashrc # FOR ZSH echo 'please' >> ~/.zshrc
-
That's it! Check if
please
command works in your terminal.
Getting a command not found: please
error? That means the Python modules installation folder is not in PATH.
To fix this:
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.profile
# Show time, quotes and tasks
please
# Add a task
please add "TASK NAME"
# Delete a task
please delete <TASK NUMBER>
# Mark task as done
please do <TASK NUMBER>
# Mark task as undone
please undo <TASK NUMBER>
# Show tasks even if all tasks are markded as done
please showtasks
# Move task to specified position
please move <OLD NUMBER> <NEW NUMBER>
# Toggle Time between 24 hours and 12 hours format
please changetimeformat
# Change your name
please callme "NAME"
# Delete all done tasks
please clean
# Reset all settings and tasks
please setup
1.Navigate to ~/.config/please
2. Open config.json
3. Add "diable_line": true
at the end (don't forget to add a ,
at the end of the previous line)
- To get started, first install poetry:
curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python -
- Clone this project
cd
to the project directory and run virtual environment:
poetry shell
# OR THIS, IF 'poetry shell' doesn't work
. "$(dirname $(poetry run which python))/activate"
- Install all dependencies:
poetry install
please
will be available to use as a command in the virtual environment after usingpoetry install
.
- Finally, run the python script with:
python please/please.py
- To build a WHL package:
poetry build
- The package will be generated in dist folder, you can then use pip to install the WHL file.
Open your terminal and type:
pip uninstall please-cli
and also edit your .zshrc or .bashrc file and remove the line that says please
at the end of the file.
- Thanks to @CodePleaseRun & @guedesfelipe for their contributions.
- Thanks to @lukePeavey for the quotes.json file taken from quotable.io