{"id":14973880,"url":"https://github.com/naveenpiedy/letterboxd_utility_tools","last_synced_at":"2025-08-30T22:17:16.523Z","repository":{"id":40957375,"uuid":"262699515","full_name":"naveenpiedy/letterboxd_utility_tools","owner":"naveenpiedy","description":"Scripts to work with Letterboxd RSS feed and CSV's. From a pipeline to a DB to generating and sorting lists. ","archived":false,"fork":false,"pushed_at":"2023-07-25T18:13:59.000Z","size":175,"stargazers_count":14,"open_issues_count":3,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-01T02:04:22.051Z","etag":null,"topics":["letterboxd","psql","python-3"],"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/naveenpiedy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-10T02:47:37.000Z","updated_at":"2024-11-10T07:43:26.000Z","dependencies_parsed_at":"2023-01-25T12:30:35.284Z","dependency_job_id":null,"html_url":"https://github.com/naveenpiedy/letterboxd_utility_tools","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naveenpiedy%2Fletterboxd_utility_tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naveenpiedy%2Fletterboxd_utility_tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naveenpiedy%2Fletterboxd_utility_tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naveenpiedy%2Fletterboxd_utility_tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/naveenpiedy","download_url":"https://codeload.github.com/naveenpiedy/letterboxd_utility_tools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238437597,"owners_count":19472441,"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":["letterboxd","psql","python-3"],"created_at":"2024-09-24T13:49:37.622Z","updated_at":"2025-02-12T08:31:48.075Z","avatar_url":"https://github.com/naveenpiedy.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Letterboxd Utility Tools ![master badge](https://img.shields.io/travis/com/naveenpiedy/letterboxd_utility_tools/master.svg?logo=travis\u0026labelColor=abcdef\u0026color=03cffc\u0026label=Master%20Build\u0026link=https://travis-ci.com/naveenpiedy/letterboxd_utility_tools\u0026style=for-the-badge)\n\nUnofficial scripts to work with Letterboxd RSS feed and CSV's. From a pipeline to a DB to generating and sorting lists.\n\n## Getting Started\n\nI suppose people reading this will already have a [Letterboxd account](https://letterboxd.com/). Exporting your data could be done through [settings](https://letterboxd.com/settings/data/). If you still have trouble, a link to their [FAQ](https://letterboxd.com/about/frequent-questions/#:~:text=To%20export%20a%20list%20from,of%20creating%20a%20new%20list.) \n\n### Prerequisites\n\nScripts make use of dataclasses, so Python 3.7+.\n\nThis was was written on a Windows machine (Win10). Nothing OS specific was used. \n\n### Installing\n\nClone the project and install the requirements from requirement.txt using the following command.\n\n```\npip install -r requirements.txt\n```\n\nIf you want to make use of database scripts, you need [PostGresSQL](https://www.postgresql.org/download/).\n\nWill update more instructions on how to get the DB set up (this is still a WIP). Minor changes to [config file](https://github.com/naveenpiedy/letterboxd_utility_tools/blob/master/src/database_pipeline_tools/base.py) should be all that is needed.  \n\n## Using the scripts\n\nThis is still a work in progress. Will definitely add CLI support or at least a main script file to call other scripts.\n\nFor now, database scripts can be found under `src/database_pipeline_tools` [here](https://github.com/naveenpiedy/letterboxd_utility_tools/tree/master/src/database_pipeline_tools) and list tools under `src/movie_list_tools` [here](https://github.com/naveenpiedy/letterboxd_utility_tools/tree/master/src/movie_list_tools).\n\nAlternatively you can refer to tests for now on how to run the scripts. If you need more info, feel free to reach me. \n\n## Running the tests\n\nTests were written using Python's unittest and is hooked up to Travis. Build status can be found on the top. If you want to run tests locally, running the following command from the root of the directory will suffice.\n\n```\npytest\n```\nTests are constantly being added to have better code coverage. \n\n### And coding style tests\n\nFor linting, flake8 is used. You could run it using the following command from the root of the directory. \n\n```\nflake8\n```\n\n## Contributing\n\nAs of writing this, there is no definite contributing guide (Will add one later). Feel free to submit a feature request or open bug. If you have implemented it already, please submit a pull request for me to take a look.  \n\nPlease read [CODE_OF_CONDUCT.md](https://github.com/naveenpiedy/letterboxd_utility_tools/blob/master/CODE_OF_CONDUCT.md) for details on our code of conduct.\n\n## Authors\n\n* **[Naveen Piedy](https://github.com/naveenpiedy)** - *Initial work* - [Letter Boxd Utility Tools](https://github.com/naveenpiedy/letterboxd_utility_tools)\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](https://github.com/naveenpiedy/letterboxd_utility_tools/blob/master/LICENSE) file for details\n\n## Acknowledgments\n\n* For [LetterBoxd](https://letterboxd.com/) being such a great website for movie lovers.\n* To that one Reddit Thread asking if there was a script to merge sort a movie list.\n* And for 2020, for giving me time and motivation to finally do my pet project. \n* etc\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaveenpiedy%2Fletterboxd_utility_tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnaveenpiedy%2Fletterboxd_utility_tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaveenpiedy%2Fletterboxd_utility_tools/lists"}