{"id":17685889,"url":"https://github.com/felipealfonsog/termnotes","last_synced_at":"2025-05-12T21:57:36.995Z","repository":{"id":180867429,"uuid":"665832131","full_name":"felipealfonsog/TermNotes","owner":"felipealfonsog","description":"Term Notes is a simple command-line utility for creating and managing notes directly from your terminal.","archived":false,"fork":false,"pushed_at":"2024-09-03T03:33:35.000Z","size":2120,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-20T18:39:48.933Z","etag":null,"topics":["console-application","note-managment","note-taking","notes","notes-tool","terminal-based","toollinux"],"latest_commit_sha":null,"homepage":"","language":"C","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/felipealfonsog.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["felipealfonsog"],"patreon":"felipealfonsogl","custom":["https://www.buymeacoffee.com/felipealfonsog"]}},"created_at":"2023-07-13T05:30:07.000Z","updated_at":"2024-09-03T03:33:39.000Z","dependencies_parsed_at":"2024-11-09T14:13:46.613Z","dependency_job_id":null,"html_url":"https://github.com/felipealfonsog/TermNotes","commit_stats":null,"previous_names":["felipealfonsog/termnotes"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipealfonsog%2FTermNotes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipealfonsog%2FTermNotes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipealfonsog%2FTermNotes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipealfonsog%2FTermNotes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/felipealfonsog","download_url":"https://codeload.github.com/felipealfonsog/TermNotes/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253830910,"owners_count":21971001,"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":["console-application","note-managment","note-taking","notes","notes-tool","terminal-based","toollinux"],"created_at":"2024-10-24T10:29:24.785Z","updated_at":"2025-05-12T21:57:36.970Z","avatar_url":"https://github.com/felipealfonsog.png","language":"C","readme":"\n### Term Notes 📋📌\n\n\"TermNotes\"* is a command-line note management utility designed to help you organize your ideas and reminders efficiently. It allows you to create, display, update, and delete notes directly from the terminal, providing you with a fast and straightforward workflow. With \"TermNotes,\" you can keep track of your thoughts and important tasks, all within your favorite command-line environment. Simplify your life and enhance your productivity with this minimalist yet powerful tool.\n\n![Version](https://img.shields.io/github/release/felipealfonsog/TermNotes.svg?style=flat\u0026color=blue)\n![Main Language](https://img.shields.io/github/languages/top/felipealfonsog/TermNotes.svg?style=flat\u0026color=blue)\n[![Open Source? Yes!](https://badgen.net/badge/Open%20Source%20%3F/Yes%21/blue?icon=github)](https://github.com/Naereen/badges/)\n\n[![MIT license](https://img.shields.io/badge/License-MIT-blue.svg)](https://lbesson.mit-license.org/)\n\u003c!--\n[![GPL license](https://img.shields.io/badge/License-GPL-blue.svg)](http://perso.crans.org/besson/LICENSE.html)\n--\u003e\n\n[![Vim Powered](https://img.shields.io/badge/Vim-Powered-%2311AB00.svg?logo=vim\u0026logoColor=white)](https://www.vim.org)\n[![VS Code Powered](https://img.shields.io/badge/VS%20Code-Powered-%23007ACC.svg?logo=visualstudiocode\u0026logoColor=white)](https://code.visualstudio.com/)\n\n\n\n\n\u003csub\u003e* This is currently an experimental phase where the primary focus is on making the system functional and establishing a practical and logical pathway that aligns with both my vision and the project's goals. It might contain errors, bugs, etc. Many other non-core elements of the project are considered secondary.\u003c/sub\u003e\n\n#### Screenshot \n\n![Screenshot of the Term Notes application interface](imgs/sshot-v.1.0.4.jpg)\n\n#\n\n#### Installation\n#### Via AUR using YAY\n\n[![AUR](https://img.shields.io/aur/version/term-notes.svg)](https://aur.archlinux.org/packages/term-notes)\n\nhttps://aur.archlinux.org/packages/term-notes\n\nTerm Notes is available on AUR (Arch User Repository), and it can be installed using the `yay` package manager. Follow the steps below to install Term Notes:\n\n1. Make sure you have `yay` installed. If not, you can install it with the following command:\n   \n   ```\n   sudo pacman -S yay\n   ```\n   Once yay is installed, you can install Term Notes by running the following command:\n   \n   ```\n   yay -S term-notes\n   ```\nThis command will automatically fetch the package from AUR and handle the installation process for you.\n\n#\n\n🚀 **Excited to Present New Features** 🚀\n\nI am thrilled to announce version 1.0.4 of the Terminal Notes Utility! I'm going even further with exciting new features and improvements! Now, Neovim is part of the options! \n\n**Implemented Changes and Features:**\n\n1. **Create Files**: Added `createFiles()` function to create the `term_notes` file in `~/.config` if it doesn't exist.\n\n2. **Move Binary**: Implemented `moveBinaryToDestination()` to move the `term-notes` binary to `/usr/local/bin/` on Linux or `/usr/local/bin/` on macOS.\n\n3. **Add Note**: Implemented `addNote()` function for adding a new note, storing its content in `notes.txt`, and providing options to edit it using `nano`, `vim`, or `neovim`.\n\n4. **Edit Note**: Added `editNote()` function for editing an existing note, displaying a list of available notes, and choosing an editor (`nano`, `vim`, or `neovim`) to edit the selected note's content.\n\n5. **Delete Note**: Implemented `deleteNote()` function to delete an existing note, showing a list of notes, and selecting one to delete.\n\n6. **Delete All Notes**: Added `deleteAllNotes()` function to delete all existing notes from `notes.txt`.\n\n7. **Show Note**: Implemented `showNote()` function for displaying the content of a specific note, requesting the note's ID, and showing its content if found.\n\n8. **Show All Notes**: Added `showAllNotes()` function to display the content of all existing notes in `notes.txt`.\n\n9. **Menus**: Created `showNotesMenu()` and `mainMenu()` functions to display the available options for managing notes and the main menu, respectively.\n\n10. **Additional Settings**: Set appropriate permissions to make the generated binary executable (`chmod`).\n\n**Call for Collaboration 🤝**\n\nI am open to collaborating with engineers and developers on this project. Working together could lead to significant learning opportunities for all involved. If you are interested in contributing to the Terminal Notes Utility, feel free to reach out and join the team!\n\n#### Changes Made for macOS and Linux Separation\n\nTo achieve compatibility with both macOS and Linux, the original term_notes.c file has been split into two separate files: term_notes_macos.c and term_notes_linux.c. This separation was necessary to address platform-specific system calls, dependencies, and path handling.\n\n- term_notes_mac.c\nThe term_notes_macos.c file includes code that is specific to macOS. This version of the utility uses platform-specific libraries and functions for path handling, file management, and other system calls to ensure seamless execution on macOS.\n\n- term_notes_linux.c\nThe term_notes_linux.c file contains code tailored to work on Linux systems. Similar to the macOS version, this file uses Linux-specific libraries and functions for path handling, file management, and other system interactions.\n\n#### Compiling and Running the Utility\n\nTo compile the Notes Manager on macOS, use the following command:\n\n```\ngcc -o term-notes-macos src/term_notes_mac.c\n```\n\nAnd for Linux, use:\n\n```\ngcc -o term-notes-linux src/term_notes_linux.c\n```\n\n**Let's make note-taking from the terminal even better!** 📝\n\n\n\n#### Term-Notes Installer 🚀\n\n[![Installer Success](https://img.shields.io/badge/Installer-Success-orange)](https://github.com/felipealfonsog/TermNotes)\n\nHey there! 👋 I'm excited to share that I successfully created a convenient Bash installer for Term-Notes, a terminal-based note-taking application.\n\n📝 With this installer, you can effortlessly install Term-Notes on your Mac OS or Linux system by executing a simple script. No more hassles with manual compilation or dependencies!\n\n🚀 The installer takes care of everything: downloading the source code, compiling the program, and even checking for Homebrew or Linux package managers to ensure smooth installation.\n\n💻 Whether you're on Mac OS or Linux, the installer streamlines the process, so you can focus on taking notes without any hassle.\n\nBy the way, we had some hurdles along the way. Homebrew didn't accept our project, but screw it! 😄 We persevered and made it happen, developing an easy-to-use installer with some cool ASCII ART!\n\n#### UPDATES: Modification for macOS and Linux\nThe original script was enhanced to determine the user's operating system and download the appropriate C source file for compilation. The modification ensures that the Term-Notes utility is compiled with the correct C source file depending on the operating system.\n\n#### To Install it: \nTo install Term-Notes, simply run the installer script available [here](https://github.com/felipealfonsog/TermNotes/raw/main/installer.sh).\n\nOr just Copy - Paste in your terminal and use -curl- to start downloading the installer:\n\n   ```\n   curl -O https://raw.githubusercontent.com/felipealfonsog/TermNotes/main/installer.sh\n   ```\n\nIf you want to use -wget- just copy/paste this line:\n\n   ```\n   wget https://github.com/felipealfonsog/TermNotes/raw/main/installer.sh\n   ```\n\n   On macOS to download - wget - just install it with Homebrew:\n\n   ```\n   brew install wget\n   ```\n\n#### Important note when installing:\n\nIf you encounter issues executing the file in the terminal, like this message \"-bash: ./installer.sh: Permission denied\", follow these simple steps to fix it:\n\n1. Open your terminal.\n2. Navigate to the directory where the installer script is located using the `cd` command.\n3. Run the following command to grant execute permission to the installer script:\n\n   ```\n   chmod +x installer.sh\n   ```\n   \n4. Now you can run the installer without any problems.\n\n   ```\n   ./installer.sh\n   ```\n   NOTE: The script will ask for -sudo permissions-. Just simply type in macOS your macOS user password, and in Linux your -sudo- password.\n\nNow type 'term-notes' in the terminal and enjoy using Term-Notes! 😊🚀\n\nFeel free to reach out if you need any further assistance!\n\n#### Updating with the script: \nIf you want to update term-notes in your system, re-run the script:\n\n   ```\n   ./installer.sh\n   ```\nPlease note that if you encounter any issues or have suggestions, feel free to raise an issue on the [TermNotes repository](https://github.com/felipealfonsog/TermNotes/issues). Your feedback is invaluable!\n\nThank you for joining me on this journey, and I hope Term-Notes brings value to your life and workflow. Let's continue making technology accessible and enjoyable for everyone!\n\n\u003c!-- \n#### Project Availability Update: Homebrew Rejection\n\n[![Homebrew Rejected](https://img.shields.io/badge/Homebrew-Not%20Accepted-yellow)](https://github.com/TermNotes)\n\nI regret to inform you that the project, Term Notes, has been rejected by Homebrew for publication in their package repository. This means that Linux users from different distros, unfortunately, won't be able to install Term Notes directly through Homebrew. However, we have an alternative solution for Arch Linux users!\n\nTerm Notes can still be installed through the YAY package manager, ensuring Arch Linux users can enjoy the benefits of the note-taking application. Simply follow the instructions provided in the project's documentation to install Term Notes using YAY.\n\nFor users on other Linux distributions and macOS, don't worry! You can still compile and use the binary file from the cloned GitHub project repository. Although it won't be installed system-wide, you can run the application directly from the project folder. I apologize for any inconvenience this may cause.\n--\u003e\n\n#### Prerequisites\n\n- GCC (GNU Compiler Collection)\n- libutil-linux\n- Nano or Vim text editor\n\n#### Compiling the Source Code\n\n1. Clone the repository:\n\n```\ngit clone https://github.com/felipealfonsog/TermNotes.git\n```\n3. Navigate to the project directory:\n\n```\ncd TermNotes/src\n```\n4. Install Libutil-linux\n\n```\nsudo pacman -S libutil-linux\n```\n\n4. Compile the source code:\n\n```\ngcc -o term-notes term_notes.c\n```\n\n#### Usage\n\n- To create a new note:\nterm_notes create\n\n- To edit an existing note:\nterm_notes edit [note_id]\n\n- To view all notes:\nterm_notes list\n\n- To delete a note:\nterm_notes delete [note_id]\n\n\n#### Contributing\n\nContributions are welcome! Here's how you can contribute to Term Notes:\n\n1. Fork the repository.\n2. Create a new branch: `git checkout -b feature/your-feature-name`.\n3. Make your changes and commit them: `git commit -m 'Add your feature'`.\n4. Push the changes to your branch: `git push origin feature/your-feature-name`.\n5. Create a new pull request.\n\n#### License\n\nTerm Notes is licensed under the MIT License. See [LICENSE](LICENSE) for more information.\n\n#### Contact\n\nHello! My name is Felipe, and I'm a passionate Computer Science Engineer. I'm also the creator of this project. If you have any questions, suggestions, or just want to chat, feel free to reach out to me. I'd be more than happy to help!\n\n- Email: f.alfonso@res-ear.ch\n- LinkedIn: [felipealfonsog](https://www.linkedin.com/in/felipealfonsog/)\n- GitHub: [felipealfonsog](https://github.com/felipealfonsog)\n\n#### Support and Contributions\n\nIf you find this project helpful and would like to support its development, there are several ways you can contribute:\n\n- **Code Contributions**: If you're a developer, you can contribute by submitting pull requests with bug fixes, new features, or improvements. Feel free to fork the project and create your own branch to work on.\n- **Bug Reports and Feedback**: If you encounter any issues or have suggestions for improvement, please open an issue on the project's GitHub repository. Your feedback is valuable in making the project better.\n- **Documentation**: Improving the documentation is always appreciated. If you find any gaps or have suggestions to enhance the project's documentation, please let me know.\n\n[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-%E2%98%95-FFDD00?style=flat-square\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://www.buymeacoffee.com/felipealfonsog)\n[![PayPal](https://img.shields.io/badge/Donate%20with-PayPal-00457C?style=flat-square\u0026logo=paypal\u0026logoColor=white)](https://www.paypal.me/felipealfonsog)\n[![GitHub Sponsors](https://img.shields.io/badge/Sponsor%20me%20on-GitHub-%23EA4AAA?style=flat-square\u0026logo=github-sponsors\u0026logoColor=white)](https://github.com/sponsors/felipealfonsog)\n\nYour support and contributions are greatly appreciated! Thank you for your help in making this project better.\n\n\n","funding_links":["https://github.com/sponsors/felipealfonsog","https://patreon.com/felipealfonsogl","https://www.buymeacoffee.com/felipealfonsog","https://www.paypal.me/felipealfonsog"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipealfonsog%2Ftermnotes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffelipealfonsog%2Ftermnotes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipealfonsog%2Ftermnotes/lists"}