{"id":28286478,"url":"https://github.com/yankh764/mdoc","last_synced_at":"2026-04-29T10:34:39.853Z","repository":{"id":230576244,"uuid":"372065593","full_name":"yankh764/mdoc","owner":"yankh764","description":"A command-line tool for managing your documents and easing your life.","archived":false,"fork":false,"pushed_at":"2021-09-18T14:41:39.000Z","size":542,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-18T00:38:46.763Z","etag":null,"topics":["c","command-line","documents","linux"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yankh764.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,"dei":null}},"created_at":"2021-05-29T20:38:54.000Z","updated_at":"2021-10-11T19:54:29.000Z","dependencies_parsed_at":"2024-03-30T15:51:39.203Z","dependency_job_id":null,"html_url":"https://github.com/yankh764/mdoc","commit_stats":null,"previous_names":["yankh764/mdoc"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/yankh764/mdoc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yankh764%2Fmdoc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yankh764%2Fmdoc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yankh764%2Fmdoc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yankh764%2Fmdoc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yankh764","download_url":"https://codeload.github.com/yankh764/mdoc/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yankh764%2Fmdoc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32422084,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T06:29:02.080Z","status":"ssl_error","status_checked_at":"2026-04-29T06:29:00.631Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["c","command-line","documents","linux"],"created_at":"2025-05-21T20:12:26.052Z","updated_at":"2026-04-29T10:34:39.848Z","avatar_url":"https://github.com/yankh764.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mdoc - A command-line tool for managing your documents\nMdoc is an improved version of my [Bash Script](https://github.com/yankh764/rdoc) written in C.  \nJust as it's description says, it's a command-line tool for managing your documents and easing your life.  \nI started developing it just out of boredom and of course because I love writing code.\n  \nThis program is dedicated to all the command-line lovers that also has lots of documents or  \nfiles to read and handle.\n\n\n## Main Features\n* Counting files\n* Listing files\n* Printing details and informations on files\n* Opening files using your favorite applications\n* Sorting results alphabetically\n* Colorful output\n  \nAnd a lot more... See [Mdoc Help Message](#mdoc-help-message)\n\n\n## Dependencies\n* A C Compiler (GCC/Clang)\n* GNU Make\n* Git\n\n\n## Installation\n1. Cloning the repository:\n    ```\n    $ git clone https://github.com/yankh764/mdoc.git\n    ```\n2. Compiling the code:\n    ```\n    $ cd mdoc\n    $ make\n    \n    Note: by default GCC is used to compile the program but you can change that  \n    by typing:\n\n    $ make CC=clang\n    ```\n3. Installing the executable to your **PATH**:\n    ```\n    # make install\n    ```\n4. Cleaning build dependencies (optional):\n    ```\n    $ make clean\n    ```\n\n## Uninstallation\n* Go to the cloned directory and type:\n    ```\n    # make uninstall\n    ```\n\n## Usage\n* It's highly recommended to read the [help message](#mdoc-help-message) before using the program. You can do that by typing:\n    ```\n    $ mdoc\n    ```\n* You must generate configurations file by typing:\n    ```\n    $ mdoc -g\n    ```\nNote: you can also do that manually. See [Manual Configurations](#manual-configurations).\n  \nAfter doing the previous steps you will be ready to enjoy your new document manager :)\n\n\n## Manual Configurations\n* Create a file with the following path: `~/.config/mdoc`\n* The configurations file is divided to 3 lines: \n    1. The documents directories paths.\n    2. The documents viewer's name.\n    3. The additional option and arguments for the documents viewer execution command (optional).\n  \nAfter doing the previous steps you will be ready to enjoy your new document manager :)\n\n\n## Mdoc Help Message\n* I decided to include it here so you could take a look at it, see all of it's features and decide if it'll serve you:\n    ```\n    Usage: mdoc [OPTIONS]... ARGUMENT\n    A command-line tool for managing your documents and easing your life.\n\n    Available options:\n     -h \t\t Display this help message\n     -g \t\t Generate new configurations file\n     -s \t\t Sort the founded documents alphabetically\n     -r \t\t Reverse the order of the founded documents\n     -a \t\t Include all documents\n     -i \t\t Ignore case distinctions while searching for the documents\n     -n \t\t Allow numerous documents opening (execution)\n     -c \t\t Count the existing documents with the passed string sequence in their names\n     -l \t\t List the existing documents with the passed string sequence in their names\n     -d \t\t Display details on the documents with the passed string sequence in their names\n     -o \t\t Open the founded document with the passed string sequence in it's name\n     -R \t\t Disable recursive searching for the documents\n     -C \t\t Disable colorful output\n\n\n    NOTES:\n      1. It's good to note that the program has multiple directories support when\n         searching for a document. So when generating the configurations you can pass\n         more than one directory absolute path which the program will search for\n         documents in it at a run time. Please separate the paths with a space.\n         Example: /path/to/dir1 /path/to/dir2 /path/to/dir3...\n\n      2. When generating the configurations, if it's desired to pass additional\n         arguments for the documents execution command, please separate them with\n         a space. Example: --arg1 --arg2 --arg3...\n\n      3. By default when using the -o option you can't open more than a document\n         in a run, but you can use the -n option with it to give the program the\n         approval to open more than one document in a run.\n\n      4. You can use the -a optoin with the -c, -l, -d and -o options instead\n         of passing an actual argument.\n\n      5. The [TIME] section in the -d option stands for the last modification\n         time, or if the document haven't been modified once, it'll stand for\n         the creation time of the document.\n\n\n    EXIT CODES:\n     0   Success\n     1   Error in the command line syntax\n     2   General error in the program\n    ```\n\n\n## TODO\n* Adding support for long options.\n\n\n## Contributing\nPull requests are welcomed...\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyankh764%2Fmdoc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyankh764%2Fmdoc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyankh764%2Fmdoc/lists"}