{"id":16717867,"url":"https://github.com/xoolive/kiosque","last_synced_at":"2025-07-08T13:11:13.563Z","repository":{"id":144803998,"uuid":"391745731","full_name":"xoolive/kiosque","owner":"xoolive","description":"Read newspaper articles in textual format","archived":false,"fork":false,"pushed_at":"2025-02-02T16:15:43.000Z","size":500,"stargazers_count":5,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-15T03:41:45.900Z","etag":null,"topics":["markdown","newspaper","pdf","python"],"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/xoolive.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license.txt","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":"2021-08-01T21:46:26.000Z","updated_at":"2025-02-02T16:58:48.000Z","dependencies_parsed_at":"2024-01-04T11:32:26.203Z","dependency_job_id":"45a54f6a-e588-45d0-b1ec-e31760b9741a","html_url":"https://github.com/xoolive/kiosque","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/xoolive%2Fkiosque","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xoolive%2Fkiosque/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xoolive%2Fkiosque/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xoolive%2Fkiosque/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xoolive","download_url":"https://codeload.github.com/xoolive/kiosque/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239207445,"owners_count":19599963,"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":["markdown","newspaper","pdf","python"],"created_at":"2024-10-12T21:34:15.698Z","updated_at":"2025-02-16T22:30:53.200Z","avatar_url":"https://github.com/xoolive.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kiosque\n\n```bash\n# Runs the textual interface\nkiosque\n# equivalent to:\nkiosque tui\n# Display the link in a pager\nkiosque preview https://...\n# link = download to file, alias = get the PDF\nkiosque download link_or_alias\nkiosque download link_or_alias output.md\n# get the PDF\nkiosque latest_issue link_or_alias\n```\n\n## Command-line interface\n\n```bash\n# prints to file (named after the url)\nkiosque https://url.com/article\n# prints to file (named output)\nkiosque https://url.com/article output.md\n# prints to stdout\nkiosque https://url.com/article -\n# read in a pager\nkiosque https://url.com/article - | bat - -l md\n# download current PDF\nkiosque [alias]\n```\n\n## Python interface\n\n```python\nfrom kiosque import Website\n\nmd_text = Website.instance(url).full_text(url)\n```\n\n## Authentication\n\nEdit the configuration file with entries as follows\n\n```conf\n[https://www.lemonde.fr/]  # or any base_url\nusername =\npassword =\n```\n\nThe configuration file location appears in the following variable:\n\n```python\nfrom kiosque import configuration_file\n```\n\n## Installation\n\n```bash\npip install kiosque\n```\n\nDevelopment version:\n\n```bash\npoetry install\n```\n\n## Supported websites\n\nA comprehensive list is available here in the [`websites.md`](websites.md) file. Support for authentication is offered for some content, but help of subscribing readers is obviously wanted to provide access to more contents. More websites are integrated as soon as an opportunity to test them arises. Pull requests are of course welcome.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxoolive%2Fkiosque","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxoolive%2Fkiosque","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxoolive%2Fkiosque/lists"}