GithubHelp home page GithubHelp logo

burgr033 / todotxtui Goto Github PK

View Code? Open in Web Editor NEW
1.0 1.0 0.0 148 KB

TODOTXTUI - an intuitive TUI for TODO.txt files

License: MIT License

Python 100.00%
python todotxt todotxt-cli todo tui cui py-cui

todotxtui's Introduction

TODOTXTUI - an intuitive TUI for TODO.txt files

Table of Contents

  1. Getting Started
  2. Usage
  3. Roadmap
  4. Contributing
  5. License
  6. Contact
  7. Acknowledgements

Getting Started

To get a local copy up and running follow these simple steps.

Installation

  1. Clone the repo
    git clone https://github.com/burgr033/todotxtui.git
  2. Install requirements
    pip install -r requirements.txt
  3. Run!
    python todotxtui.py

Usage

config.json

  • debug
    • (true|false) debug parameter (generates log file in running dir)
  • unicode_borders
    • (true|false) If you want unicode rounded sexy corners or not
  • color_projects
    • (true|false) Feature is implemented but useless due to the limited colors of py_cui
  • todo_file_path
    • File Path for your Todo.txt file
  • WIP_identifier
    • This is the Keyword which is applied when you put something in "DOING" (e.g. "@WIP")
  • alternate_today
    • alternate keyword for today (maybe in your language)
  • alternate_tomorrow
    • alternate keyword for tomorrow (maybe in your language)
  • editor_path
    • full path to editor for opening text files

Modes

  • OverView Mode
    • in overview mode you can cycle through widgets with arrows keys, and enter focus mode with enter.
      • you can also toggle some functions with following keys:
        • q - quit application
        • TAB - cycle through widgets without using arrow keys and ENTER
        • f - find and mark | opens find/mark dialog (also upon opening the find/mark dialog the previously marked items are cleared)
        • r - refresh | refreshes the whole GUI and reloads changes made to todo.txt file from any other source
        • o - opens todo.txt in default system editor.
  • Focus Mode
    • TODO Item Widget: Just hammer in your new TODO and press enter.
      • if you want a due date, than use due:2020-03-10 format. If you want to use due date today or tomorrow you can just type due:today or due:tomorrow (or the alternate keywords you set in config.json) it will be replaced with the according date. Today will be marked red and tomorrow will be marked yellow.
    • FUNNEL in this widget is everything you are not currently working on.
      • ESC - for exiting the widget.
      • ENTER on respective item moves it to "DOING"
    • DOING in this widget is everything you are working on at the moment
      • ESC - for exiting the widget.
      • ENTER on respective item moves it to "DONE"
    • DONE in this widget is everything finished.
      • ESC - for exiting the widget.
      • DEL for deleting items from the todo.txt list entirely

Screenshots

Workflow

Roadmap

nothing, really

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

License

Distributed under the MIT License. See LICENSE for more information.

Note

  • Please note, that I don't know what the fuck I am doing. I just google stuff and use code snippets from StackOverflow. If you killed your todo.txt using this application, joke on you. No Backup? No Mercy!
  • Also note, that this is fully compatible with todotxt standard, but does not fully implement it, so it is not strictly following todotxt syntax (e.g. there is a completion date set upon completion, but todotxt standard says when you set completion date, you need creation date, and i don't provide creation date simply, because i needed the space on the screen)

Contact

@burgr033 - [email protected]

Project Link: https://github.com/burgr033/todotxtui

Acknowledgements

todotxtui's People

Contributors

burgr033 avatar

Stargazers

Ryan Shaw avatar

Watchers

 avatar

todotxtui's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.