{"id":24483737,"url":"https://github.com/lolitemaultes/phonebooker-pro","last_synced_at":"2025-03-14T20:27:23.903Z","repository":{"id":265612440,"uuid":"896337276","full_name":"lolitemaultes/PhoneBooker-Pro","owner":"lolitemaultes","description":"User Friendly Phonebook Managing Application","archived":false,"fork":false,"pushed_at":"2024-11-30T11:54:28.000Z","size":138,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-21T13:12:11.147Z","etag":null,"topics":["data-management","management","phone-book","phonebook","tool","user-friendly","vcf","vcf-data","xml","xml-phone-book-reader"],"latest_commit_sha":null,"homepage":"","language":"Python","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/lolitemaultes.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}},"created_at":"2024-11-30T04:57:58.000Z","updated_at":"2024-11-30T11:54:31.000Z","dependencies_parsed_at":"2024-11-30T09:11:17.352Z","dependency_job_id":null,"html_url":"https://github.com/lolitemaultes/PhoneBooker-Pro","commit_stats":null,"previous_names":["lolitemaultes/phonebooker-pro"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lolitemaultes%2FPhoneBooker-Pro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lolitemaultes%2FPhoneBooker-Pro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lolitemaultes%2FPhoneBooker-Pro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lolitemaultes%2FPhoneBooker-Pro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lolitemaultes","download_url":"https://codeload.github.com/lolitemaultes/PhoneBooker-Pro/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243641250,"owners_count":20323815,"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":["data-management","management","phone-book","phonebook","tool","user-friendly","vcf","vcf-data","xml","xml-phone-book-reader"],"created_at":"2025-01-21T13:12:15.469Z","updated_at":"2025-03-14T20:27:23.868Z","avatar_url":"https://github.com/lolitemaultes.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![logo](https://github.com/user-attachments/assets/41ca9d19-638d-458d-aaf0-55850c06ac52)\n\n\n**PhoneBooker Pro** is a modern and user-friendly phonebook management application designed to help you organize, edit, and convert your contact lists effortlessly. Built using Python and PyQt6, this application offers sleek styling, intuitive controls, and powerful features for seamless contact management.\n\n## Features\n\n- **Contact Management:**\n  - Add, edit, and delete contacts with ease.\n  - Group contacts into categories like Work, Friends, Family, etc.\n  - Search and filter contacts with advanced options, including fuzzy matching.\n\n- **File Formats:**\n  - Import and export contacts in XML and VCF formats.\n  - Convert phonebooks between XML and VCF formats.\n\n- **Modern Interface:**\n  - Clean, responsive UI with support for dark and light themes.\n  - Customizable styling for buttons, tables, and inputs.\n\n- **Advanced Tools:**\n  - Case-sensitive and exact match search options.\n  - CSV import with duplicate detection.\n  - Alphabetical sorting of contacts by name.\n\n## Getting Started\n\n### Prerequisites\n\nEnsure you have the following installed on your system:\n- Python 3.8+\n- Required Python packages:\n\n  ```bash\n  pip install PyQt6 thefuzz\n  ```\n\n### Installation\n\n1. Clone this repository:\n\n   ```bash\n   git clone https://github.com/lolitemaultes/PhoneBooker-Pro.git\n   cd PhoneBooker-pro\n   ```\n\n2. Run the application:\n\n   ```bash\n   python \"PhoneBooker Pro.py\"\n   ```\n\n### Running as an Executable\n\nTo create an executable for distribution, use PyInstaller:\n```bash\npyinstaller --onefile --windowed \"PhoneBooker Pro.py\"\n```\n\nThe generated executable will be available in the `dist` folder.\n\n## Usage\n\n### Starting the Application\nOn launch, the app displays a startup menu:\n- **Edit Phonebook:** Manage your contacts in an interactive table view.\n- **Convert Phonebook:** Convert XML to VCF or vice versa.\n\n### Contact Operations\n- Double-click a contact to edit it.\n- Use the action buttons to add, delete, or save contacts.\n\n### File Operations\n- Import contacts from a CSV file or load an XML file.\n- Export your phonebook as an XML or VCF file.\n\n## Screenshots\n\n![Screenshot from 2024-11-30 16-16-43](https://github.com/user-attachments/assets/1a7efede-c8c8-44fb-8244-662ddfdf524c)\n![Screenshot from 2024-11-30 16-17-33](https://github.com/user-attachments/assets/a8feb997-dbe9-4342-ac7a-f6dedcdef594)\n![Screenshot from 2024-11-30 16-17-09](https://github.com/user-attachments/assets/6507d2ad-3764-4c1b-97af-5279a7c7b195)\n\n## Roadmap\n\nPlanned features:\n- Additional export formats.\n- Integration with cloud-based contact storage.\n- Real-time syncing with mobile devices.\n\n## Contributing\n\nContributions are welcome! Please fork the repository, create a new branch, and submit a pull request.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flolitemaultes%2Fphonebooker-pro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flolitemaultes%2Fphonebooker-pro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flolitemaultes%2Fphonebooker-pro/lists"}