PHPackages                             tshw/php-todo-txt - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. tshw/php-todo-txt

ActiveLibrary[Utility & Helpers](/categories/utility)

tshw/php-todo-txt
=================

PHP library for the todo.txt unstructured todo list format.

v0.1.0(1y ago)01GPL-3.0-or-laterPHPCI passing

Since Jun 22Pushed 1y agoCompare

[ Source](https://github.com/Tar-Minyatur/PhpTodoTxt)[ Packagist](https://packagist.org/packages/tshw/php-todo-txt)[ RSS](/packages/tshw-php-todo-txt/feed)WikiDiscussions main Synced today

READMEChangelog (3)Dependencies (1)Versions (3)Used By (0)

PHPTodoTxt [![Run Test [Composer]](https://github.com/Tar-Minyatur/PhpTodoTxt/actions/workflows/php.yml/badge.svg)](https://github.com/Tar-Minyatur/PhpTodoTxt/actions/workflows/php.yml)
=========================================================================================================================================================================================

[](#phptodotxt-)

PHP library for the [todo.txt](https://todotxt.org/) unstructured todo list format.

What is todo.txt?
-----------------

[](#what-is-todotxt)

It's a simple file format for the todo text file that many people probably have on their desktop somewhere.

A todo.txt file following this standard looks like this:

```
A simple task is just a line
x This task is done, indicated by the lowercase x
(F) Prioritization is important, so this is priority F
2025-01-01 This task has its creation date mentioned
x 2025-01-01 2024-05-01 This task is done and has a completion and creation date
For +myCoolProject I need to write documentation
When I'm @work I need to plan my next vacation

```

You get the gist. It's simple, but more structured than just writing down stuff.

To lean more, you can head to [todotxt.org](http://todotxt.org/) to learn more.

Features
--------

[](#features)

- Robustly parses the todo.txt
- Provides an easy-to-use model to access and modify tasks
- Task description is available als "clean" version without trailing tags
- Projects, contexts and meta data are available separately as arrays

Installation
------------

[](#installation)

Use composer to add as dependency:

```
$ composer require tshw/php-todo-txt

```

Usage
-----

[](#usage)

Create an object of the main class by reading tasks from a file:

```