{"id":28224702,"url":"https://github.com/yaaama/megatui","last_synced_at":"2025-06-12T07:30:43.465Z","repository":{"id":287907921,"uuid":"966200800","full_name":"yaaama/megatui","owner":"yaaama","description":"A terminal user interface to manage your files on MEGA","archived":false,"fork":false,"pushed_at":"2025-06-04T23:38:39.000Z","size":261,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-05T04:48:48.427Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/yaaama.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,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-14T14:57:16.000Z","updated_at":"2025-06-04T23:38:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"9ec7b9d1-9055-4ef6-9070-e9cbe338c930","html_url":"https://github.com/yaaama/megatui","commit_stats":null,"previous_names":["yaaama/megatui"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/yaaama/megatui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yaaama%2Fmegatui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yaaama%2Fmegatui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yaaama%2Fmegatui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yaaama%2Fmegatui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yaaama","download_url":"https://codeload.github.com/yaaama/megatui/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yaaama%2Fmegatui/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259420370,"owners_count":22854561,"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":[],"created_at":"2025-05-18T09:12:48.233Z","updated_at":"2025-06-12T07:30:43.460Z","avatar_url":"https://github.com/yaaama.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MegaTUI - Terminal User Interface for MEGA\n\n[![Python](https://img.shields.io/badge/Python-FFD43B?style=for-the-badge\u0026logo=python\u0026logoColor=blue)](https://www.python.org/)\n[![License: GPLv3](https://img.shields.io/badge/GPL--3.0-red?style=for-the-badge)](https://opensource.org/license/gpl-3-0)\n\n---\n\n**THIS IS A WORK IN PROGRESS!**\n\nNavigate and manage your MEGA cloud storage directly from the comfort of your\nterminal! MegaTUI provides an intuitive text-based user interface (TUI)\npowered by the excellent [Textual](https://github.com/Textualize/textual)\nframework.\n\nIt interacts with your MEGA account by leveraging the official\n[MEGAcmd](https://github.com/meganz/MEGAcmd) command-line tools in the\nbackground.\n\nThe UI and bindings are inspired by [ranger](https://github.com/ranger/ranger) and\n[lf](https://github.com/gokcehan/lf).\n\n![megatui screenshot](./assets/screenshot.png)\n\n## Showcase\n\n### Renaming a file\n\n![Renaming a file demonstration](./assets/demo/rename-file.gif)\n\n## 🪷 Features\n\nAs of writing this (_2025-06-06_), work is still ongoing and active.\n\n- **Browse Files:** Navigate through your MEGA cloud drive folders.\n- **Basic Navigation:** Use intuitive keybindings (like `j`/`k`, `h`/`l`, `Enter`/`Backspace`) to move up, down, into, and out of directories.\n- **Directory Listing:** View files and directories within the current path.\n- **Status Bar:** See information about the currently selected item.\n- **Refresh:** Update the current directory view.\n- **Rename file/directories:** Rename files via the app.\n- **Login Check:** Verifies your MEGAcmd login status on startup.\n\n## ✏️ (Planned / TODO)\n\n- [x] Implement file operations (Get, Put, Rename, Delete, Copy, Move) based on supported `mega-*` commands.\n- [ ] Search functionality.\n- [ ] Multi-pane views.\n- [ ] Caching to improve performance.\n- [ ] File Previews (basic info, potentially text content).\n- [ ] Display detailed directory/account usage (total storage usage, account details, etc).\n- [ ] Robust error handling.\n- [ ] Configuration options.\n- [ ] Background transfer monitoring.\n- [ ] Logging in (with 2FA support), and logging out.\n\n## ⚙️ Installation (Development Only)\n\n**These instructions are for development purposes only. The package is not even in alpha!**\n\nBefore you begin, ensure you have the following installed:\n\n1.  **Python:** Version 3.13 is what is currently being used (subject to change potentially).\n2.  **MEGAcmd:** The official MEGA command-line tool.\n\n    - Download and install it from the [official MEGAcmd GitHub releases page](https://github.com/meganz/MEGAcmd/releases).\n    - **Crucially:** You need to **log in** to your MEGA account using MEGAcmd\n      _before_ running MegaTUI.\n      - Open your terminal and run `mega-login your-email@example.com` and follow the prompts.\n        You can verify your login status with `mega-whoami`.\n      - MegaTUI currently relies on an existing MEGAcmd session.\n    - Run `mega-cmd-server` as a daemon process in the background (speed of\n      command execution will be severely reduced otherwise).\n\n3.  **(Recommended)** Install `uv` for package and virtual environment management.\n4.  `git clone https://github.com/yaaama/megatui.git \u0026\u0026 cd megatui`\n5.  `uv sync`\n6.  To run the project: `uv run /path/to/main.py`\n\n## 📄 License\n\nThis project is licensed under the GPL 3.0 License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgements\n\n- [Textual](https://github.com/Textualize/textual) for the awesome TUI framework.\n- [MEGA](https://mega.nz/) and the developers for their tools!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyaaama%2Fmegatui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyaaama%2Fmegatui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyaaama%2Fmegatui/lists"}