{"id":16778338,"url":"https://github.com/deeplook/filereader","last_synced_at":"2025-03-16T19:26:18.935Z","repository":{"id":66092347,"uuid":"65931783","full_name":"deeplook/filereader","owner":"deeplook","description":"A very crude textfile reader using Apple's say tool on Mac OS X.","archived":false,"fork":false,"pushed_at":"2016-08-20T08:13:12.000Z","size":22,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-23T06:12:04.037Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/deeplook.png","metadata":{"files":{"readme":"README.rst","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":"2016-08-17T18:21:57.000Z","updated_at":"2016-12-14T15:19:36.000Z","dependencies_parsed_at":null,"dependency_job_id":"433dc550-5acd-40e1-b8d1-10a2b01cd263","html_url":"https://github.com/deeplook/filereader","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/deeplook%2Ffilereader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deeplook%2Ffilereader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deeplook%2Ffilereader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deeplook%2Ffilereader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deeplook","download_url":"https://codeload.github.com/deeplook/filereader/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243918643,"owners_count":20368746,"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":"2024-10-13T07:27:26.691Z","updated_at":"2025-03-16T19:26:18.913Z","avatar_url":"https://github.com/deeplook.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Filereader\n==========\n\nThis is a very quick attempt at writing a tool that will read a text file\nloud to you using an external tool, in this case Apple's ``say`` command\navailable in any console on Max OS X. Ironically, this was written after\nreading Pieter Hintjens' book `Social Architecture`_ (much recommened) in\nsome inspired meta-state of trying to automate what had just happend (or\nsomething like this).\n\nThis initial version maintains a bookmark per textfile to the last\nparagraph read and will, when rerun on the same file, repeat this last\nparagraph and continue reading from there.\n\nThe paragraph numbers are basically line numbers, not counting empty lines,\nbut including also those lines that will actually not be read, because the\nare filtered, being comments or whatever.\n\nYou could record the audio by using ffmpeg or sox, which might be included\nin a future version... But it is very questionable if a real human can\nlisten to larger amounts of text read by such a super-crude tool like this.\n\nThis code is not yet packaged or installable in any sense, being simply\na prototype, and was tested only on Python 3.5.\n\nThe self-test shown below does actually run on the online version of\nPieter's book mentioned above after fetching it first from github (this\nwill use the ``requests`` package which is the only external dependency).\n\n\nSample output (self-test)\n-------------------------\n\n.. code-block:: console\n\n    $ python filereader.py\n    filereader.py - Read a textfile using \"say\" (on Mac OS X).\n    Usage: filereader.py \u003ctextfile\u003e\n           filereader.py -t\n    Stop with ctrl-c.\n\nBelow the spoken textlines were wrapped manually in order to reduce the\nneed for scrolling.\n\n.. code-block:: console\n\n    $ python filereader.py -t\n    Downloading \"https://github.com/hintjens/socialarchitecture/archive/master.zip\"...\n    Extracting \"master.zip\"...\n    Reading...\n    socialarchitecture-master/ch00.txt\n    (2) Preface\n\n    (3) The Wisdom of Crowds\n\n    (4) Niccolo Machiavelli observed, in \"//Discourses on the First Decade\n    of Titus Livius//\" that:\n\n    (5) \"As for prudence and stability of purpose, I affirm that a people\n    is more prudent, more stable, and of better judgment than a prince.\n    Nor is it without reason that the voice of the people has been likened\n    to the voice of God; for we see that wide-spread beliefs fulfill\n    themselves, and bring about marvelous results.\"\n\n    ^C\n    Created/updated bookmark to para #5 for file\n    \"socialarchitecture-master/ch00.txt\" in bookmarks.json.\n\n\n.. _Social Architecture: https://www.amazon.com/Social-Architecture-Building-line-Communities-ebook/dp/B01F8I7Z7E\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeeplook%2Ffilereader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeeplook%2Ffilereader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeeplook%2Ffilereader/lists"}