{"id":22249724,"url":"https://github.com/jakubvalenta/human-activities","last_synced_at":"2025-08-02T14:04:43.559Z","repository":{"id":43248155,"uuid":"172239796","full_name":"jakubvalenta/human-activities","owner":"jakubvalenta","description":"monitor size of directories","archived":false,"fork":false,"pushed_at":"2023-12-09T00:44:07.000Z","size":1175,"stargazers_count":3,"open_issues_count":2,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-30T11:11:42.506Z","etag":null,"topics":["filesystem","gui","monitor","productivity","utility"],"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/jakubvalenta.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-02-23T17:00:02.000Z","updated_at":"2024-06-05T19:23:42.000Z","dependencies_parsed_at":"2023-01-21T15:02:49.784Z","dependency_job_id":null,"html_url":"https://github.com/jakubvalenta/human-activities","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakubvalenta%2Fhuman-activities","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakubvalenta%2Fhuman-activities/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakubvalenta%2Fhuman-activities/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakubvalenta%2Fhuman-activities/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jakubvalenta","download_url":"https://codeload.github.com/jakubvalenta/human-activities/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245458703,"owners_count":20618697,"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":["filesystem","gui","monitor","productivity","utility"],"created_at":"2024-12-03T06:28:24.257Z","updated_at":"2025-03-25T12:15:14.794Z","avatar_url":"https://github.com/jakubvalenta.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Human Activities\n================\n\n*monitor size of directories*\n\nHuman Activities is an application that displays a **pie chart icon** in the\nWindows Taskbar, macOS Menu Bar or Linux System Tray. The icon shows ratio\nbetween the number of files in configured directories. When clicked, a menu with\na list of the directories and the exact number of files appears.\n\n.. image:: ./screenshots/human_activities_macos.png\n   :alt: Human Activities running on macOS\n\n.. image:: ./screenshots/human_activities_win7.png\n   :alt: Human Activities running on Windows 7\n\n.. image:: ./screenshots/human_activities_ubuntu.png\n   :alt: Human Activities running on Ubuntu\n\nThe application can be **configured** to compare the size of the data in the\ndirectories instead of the number of files in them. It can also be configured to\nonly count files that are newer than specified number of days.\n\nHuman Activities is an **offline** application. It doesn't send any data over the\ninternet.\n\nThe Human Activities project\n----------------------------\n\nThis application is part of the `Human Activities`_ project which focuses on\nlimiting the exploitation of individuals as part of contemporary production\nrelationships. Read more about the project on its `website \u003cHuman\nActivities_\u003e`_.\n\nThe Human Activities project was partially **financed by** `The Foundation for\nContemporary Arts Prague`_.\n\nInstallation\n------------\n\nWindows 7 and 8\n^^^^^^^^^^^^^^^\n\n1. Download and open `Human_Activities-win7.exe`_. The app will start\n   immediately. No installation process is required.\n2. To launch the application automatically each time you start the computer,\n   copy ``Human_Activities-win7.exe`` into the *Startup* folder of the Start Menu.\n3. To make sure that the application icon is always visible:\n\n   a) Click the arrow icon in the Taskbar and select *Customize*.\n   b) In the window that opens up, choose *Show icon and notifications* next to\n      the item *Human Activities*.\n\nSecurity\n\"\"\"\"\"\"\"\"\n\nBefore opening `Human_Activities-win7.exe`_, you can check the sha256 checksum\nof this file:\n\n::\n\n   6d5cfa9766ceec45d195ebbba1b06a85f176e28f88e1b660c92ad63711b023eb  Human_Activities-win7.exe\n\nWindows 10\n^^^^^^^^^^\n\n1. Download and open `Human_Activities-win10.exe`_. The app will start\n   immediately. No installation process is required.\n2. To launch the application automatically each time you start the computer:\n\n   a) Press ``WIN+R``. In the window that pops up, write the command\n      ``shell:startup`` and click OK.\n   b) Then move ``Human_Activities-win10.exe`` to the window that opens up.\n\n3. To make sure that the application icon is always visible:\n\n   a) Click on the arrow icon (*Show Hidden Icons*) in the Taskbar and select *Taskbar Settings*.\n   b) In the window that opens up, click on *Select which icons appear on the\n      Taskbar* and then switch item *Human Acitivities* on.\n\nSecurity\n\"\"\"\"\"\"\"\"\n\nBefore opening `Human_Activities-win10.exe`_, you can check the sha256 checksum\nof this file:\n\n::\n\n   bc5343c7346c177d33e998bd144a3b5d389508e5b051bc3b5f6935866e8d3fd3  Human_Activities-win10.exe\n\nmacOS\n^^^^^\n\nRequires macOS Mojave or newer. Tested on macOS Mojave.\n\n1. Download `Human_Activities-1.0.0.zip`_ and open it.\n2. Move the file ``Human Activities.app`` to *Applications*.\n3. Human Activities can now be started from *Launcher*.\n4. To launch the application automatically each time you start the computer:\n\n   a) Open *System Preferences* \u003e *Users \u0026 Groups*.\n   b) Click on the tab *Login Items*,\n   c) Click on the little plus sign icon and select the app *Human Activities*.\n\nSecurity\n\"\"\"\"\"\"\"\"\n\nBefore opening `Human_Activities-1.0.0.zip`_, you can check the sha256 checksum\nof this file:\n\n::\n\n   8b4657d276b0e397d9fca6a77769ef4dd90bca894ea44a1a5008bd25947c94ce  Human_Activities-1.0.0.zip\n\nUbuntu\n^^^^^^\n\nTested on Ubuntu 18.04 LTS and 19.10.\n\n1. Download and open `human-activities_1.0.0-1_all.deb`_.\n2. Click the button *Install* in the window that opens up.\n3. Human Acitivies can now be started from the main *Applications* menu. It will\n   also start automatically each time you start the computer.\n\nSecurity\n\"\"\"\"\"\"\"\"\n\nBefore installing the package, you can verify its GPG signature:\n\n::\n\n   $ gpg --recv-key 11E74F7E\n   $ dpkg-sig --verify human-activities_1.0.0-1_all.deb\n   Processing human-activities_1.0.0-1_all.deb...\n   GOODSIG _gpgbuilder E7582303262850695EF0B8A797C3CB6A11E74F7E 1580146502\n\nArch Linux\n^^^^^^^^^^\n\nBuild the package from provided `PKGBUILD`_ or download\n`human-activities-1.0.0-1-any.pkg.tar.xz`_ and install it with pacman.\n\nUsage\n-----\n\nSetup\n^^^^^\n\nWhen Human Activities is started for the first time, it will show a **setup\nwindow** (this might take a few seconds).\n\n.. image:: ./screenshots/human_activities_macos_setup.png\n   :alt: Setup of Human Activities\n\nHere you can choose which directories to monitor. You can only **choose existing\ndirectories**. The app doesn't create any new directories itself. When you\nremove a directory, it will be removed only from the app, your files will stay on\nthe disk. Human Activities never creates, modifies or deletes any files.\n\nIcon and menu\n^^^^^^^^^^^^^\n\n.. image:: ./screenshots/human_activities_macos.png\n   :alt: Human Activities running on macOS\n\nWhen the setup is finished, Human Activities shows a **pie chart** icon with\nratio between the number of files in the directories configured in the\nsetup. The **colors** are assigned to the directories automatically.\n\nWhen you click the icon you can see a **menu** with the exact number of files in\nthe directories and the exact percentages.\n\nYou can also see a note that **only files modified in the past 30 days** are\ncounted to the size of a directory. This behavior can be changed in the\n*Advanced configuration*.\n\nFrom the menu, you can also reach the *Setup* (which you saw when you first\nstarted the app) and the *Advanced configuration*. On Windows, these items are\naccessible in separate menu that opens when you right-click the icon.\n\nHow the pie chart is calculated\n\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\n\nLet's say we chose two directories during the setup:\n\n- ``/Users/jakub/Paid work`` which contains 15 files\n- ``/Users/jakub/Unpaid work`` which contains 30 files\n\nThen Human Activities will first calculate the **sum of the number of files in\nboth directories**, which is 45. This will be the **100%**. Therefore ``Paid\nwork`` takes 33.3% and ``Unpaid work`` takes 66.6% of the total number of\nfiles. This percentage will then be shown as a pie chart, which is ⅓ one color\nand ⅔ another color.\n\nAdvanced configuration\n^^^^^^^^^^^^^^^^^^^^^^\n\n.. image:: ./screenshots/human_activities_macos_configuration.png\n   :alt: Advanced configuration of Human Activities\n\nThe advanced configuration allows you to:\n\n- **Count the size of the data in the directories instead of the number of files\n  in them.**\n- Change how new (in terms of modification time) the files have to be to be\n  counted.\n- Give custom names to the configured directories.\n\nIgnoring files\n^^^^^^^^^^^^^^\n\nHuman Activities never counts **hidden files and directories**.\n\nAdditionaly, the application ignores some **common system files and\ndirectories** such as ``Thumbs.db`` on Windows. You can find the exact list of\nignore patterns in `human-activities.fdignore`_. (On Linux, this file is also\navailable at ``/etc/xdg/human-activities/human-activities.fdignore`` after the\ninstallation of the app.)\n\nTo configure which files get ignored, copy `human-activities.fdignore`_ to:\n\n- ``C:\\\\Users\\NAME\\AppData\\roaming\\human-activities\\human-activities.fdignore``\n  on Windows\n- ``/Users/NAME/Preferences/cz.jakubvalenta.human-activities/human-activities.fdignore``\n  on macOS\n- ``~/.config/human-activities/human-activities.fdignore`` on Linux\n\nThen edit the file to your liking. It uses the `.gitignore`_ syntax.\n\nUninstallation\n--------------\n\nWindows 7 and 8\n^^^^^^^^^^^^^^^\n\nDelete ``Human_Activities-win7.exe`` from the *Startup* folder of the Start Menu.\n\nWindows 10\n^^^^^^^^^^\n\n1. Press ``WIN+R``. In the window that pops up, write the command\n   ``shell:startup`` and click OK.\n2. Then delete ``Human_Activities-win10.exe`` from the window that opens up.\n\nmacOS\n^^^^^\n\nDelete ``Human Activities.app`` from the *Applications* folder.\n\nUbuntu\n^^^^^^\n\n1. Open *Ubuntu Software* and click on the tab *Installed*.\n2. Scroll to *Human Activities* and click the button *Remove*.\n\nArch Linux\n^^^^^^^^^^\n\nUninstall the package ``human-activities`` using pacman.\n\nSupport and help\n----------------\n\nPlease use `GitHub Issues`_.\n\nDevelopment\n-----------\n\nBuilding and running from source\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nWindows\n\"\"\"\"\"\"\"\n\n::\n\n   $ pip install Pillow pathspec sqlalchemy wxpython\n   $ python -m human_activities --verbose\n\nMac\n\"\"\"\n\n::\n\n   $ pip3 install Pillow pathspec sqlalchemy PyQt5\n   $ python3 -m human_activities --verbose\n\nArch Linux\n\"\"\"\"\"\"\"\"\"\"\n\n::\n\n   # pacman -S pipenv python-wxpython\n   $ make setup\n   $ make run-debug\n\nCreating distribution packages\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nWindows 7 and 8\n\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\n\n::\n\n   $ pip install Pillow pathspec sqlalchemy wxpython\n   $ pip install pyinstaller\n   $ win7/pyinstaller.cmd\n\nWindows 10\n\"\"\"\"\"\"\"\"\"\"\n\n::\n\n   $ pip install Pillow pathspec sqlalchemy wxpython\n   $ pip install pyinstaller\n   $ win10/pyinstaller.cmd\n\nMac\n\"\"\"\n\n::\n\n   $ pip3 install Pillow pathspec sqlalchemy PyQt5==5.15.2\n   $ pip3 install pyinstaller\n   $ make dist-mac\n\nDebian\n\"\"\"\"\"\"\n\nInstall Docker and start it. Then run:\n\n::\n\n   $ make dist-debian-build dist-debian\n\nAdditionally, you can sign the created package with GPG:\n\n::\n\n   $ make dist-debian-sign key_id='\u003cgpg key fingerprint\u003e'\n\nArch Linux\n\"\"\"\"\"\"\"\"\"\"\n\n::\n\n   $ make dist-arch-linux\n\nNotice that the package is not built from the currently checked out revision,\nbut from a git tag specified as ``v`` + Makefile variable ``_version``.\n\nTranslation\n^^^^^^^^^^^\n\nEdit the ``lang/*.po`` files and then run::\n\n   $ make clean-lang gen-lang\n\nTesting and linting\n^^^^^^^^^^^^^^^^^^^\n\n::\n\n   $ make test\n   $ make lint\n\nContributing\n------------\n\n**Feel free to remix this project** under the terms of the GNU General Public\nLicense version 3 or later. See `COPYING`_ and `NOTICE`_.\n\n.. _Human Activities: http://humanactivities.cz/\n.. _The Foundation for Contemporary Arts Prague: https://fca.fcca.cz/en/news/\n.. _Human_Activities-win7.exe: https://github.com/jakubvalenta/human-activities/releases/download/v1.0.0/Human_Activities-win7.exe\n.. _Human_Activities-win10.exe: https://github.com/jakubvalenta/human-activities/releases/download/v1.0.0/Human_Activities-win10.exe\n.. _Human_Activities-1.0.0.zip: https://github.com/jakubvalenta/human-activities/releases/download/v1.0.0/Human_Activities-1.0.0.zip\n.. _human-activities_1.0.0-1_all.deb: https://github.com/jakubvalenta/human-activities/releases/download/v1.0.0/human-activities_1.0.0-1_all.deb\n.. _human-activities-1.0.0-1-any.pkg.tar.xz: https://github.com/jakubvalenta/human-activities/releases/download/v1.0.0/human-activities-1.0.0-1-any.pkg.tar.xz\n.. _GitHub Issues: https://github.com/jakubvalenta/human-activities/issues\n.. _COPYING: ./COPYING\n.. _NOTICE: ./NOTICE\n.. _PKGBUILD: ./arch_linux/PKGBUILD\n.. _human-activities.fdignore: ./human_activities/etc/human-activities.fdignore\n.. _.gitignore: https://git-scm.com/docs/gitignore\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjakubvalenta%2Fhuman-activities","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjakubvalenta%2Fhuman-activities","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjakubvalenta%2Fhuman-activities/lists"}