btw-i-use-arch


Namebtw-i-use-arch JSON
Version 0.2.0 PyPI version JSON
download
home_pagehttps://github.com/kellerjustin/btw_i_use_arch
SummaryHelper CLI for installing packages and setting up Linux components
upload_time2023-10-30 13:35:12
maintainer
docs_urlNone
authorJustin Keller
requires_python>=3.5
licenseMIT license
keywords btw_i_use_arch
VCS
bugtrack_url
requirements dbus-python Click keyring requests simple-term-menu appdirs
Travis-CI
coveralls test coverage No coveralls.
            ==============
BTW I Use Arch
==============


.. image:: https://img.shields.io/pypi/v/btw_i_use_arch.svg
        :target: https://pypi.python.org/pypi/btw_i_use_arch

.. image:: https://img.shields.io/travis/kellerjustin/btw_i_use_arch.svg
        :target: https://travis-ci.com/kellerjustin/btw_i_use_arch

.. image:: https://readthedocs.org/projects/btw-i-use-arch/badge/?version=latest
        :target: https://btw-i-use-arch.readthedocs.io/en/latest/?version=latest
        :alt: Documentation Status


.. image:: https://pyup.io/repos/github/kellerjustin/btw_i_use_arch/shield.svg
     :target: https://pyup.io/repos/github/kellerjustin/btw_i_use_arch/
     :alt: Updates



Helper menu-driven CLI for installing packages and setting up Linux components on an 
Arch-based system.
If performing a clean install - ALWAYS RUN PACMAN SYSTEM UPDATES FIRST!
Disclaimer: I have built precisely one Arch system and spend the majority of my time 
using Manjaro KDE, which suits my needs nicely. I like Arch! But I think I might 
actually prefer Manjaro. This package works equally well for either distro. 


* Free software: MIT license
* Documentation: https://btw-i-use-arch.readthedocs.io.


Features
--------

* Menu-driven (uses simple-term-menu)
* Update components and perform setup tasks more simply


Notes for specific packages:
----------------------------

Spelling check packages
^^^^^^^^^^^^^^^^^^^^^^^

``aspell
hunspell-en_US
hspell
libviokko``

DB Drivers for GNUCash
^^^^^^^^^^^^^^^^^^^^^^

``libdbi
libdbi-drivers``

Packages required to enable gestures for touchpad
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

``xdotool
xf86-input-synaptics
libinput-gestures``

KDE-Specific Widget for setting up like Mac-like dock
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

``latte-dock``

KDE-Specific Widget - Configures Title bar in Global Menu
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

https://www.dedoimedo.com/computers/plasma-look-like-mac.html
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

``plasma5-applets-active-window-control``

Post-installation Tasks:
------------------------

Set up latte dock and widgets
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

If going for the dock / top menu bar look, search the apps menu for dock and add it.
Drag the menu bar from the bottom to the top and add the global menu, active window control, and a spacer (L-to-R). Edit the settings of
active window control so it shows the Minimize and Maximize buttons.
Run this to remove the top title bar when windows are maximized:
``kwriteconfig5 --file ~/.config/kwinrc --group Windows --key BorderlessMaximizedWindows true
qdbus org.kde.KWin /KWin reconfigure``
`Reference for removing title bar <https://askubuntu.com/questions/253337/remove-title-bar-and-borders-on-maximized-windows-in-kubuntu>`_

initialize postgres:
^^^^^^^^^^^^^^^^^^^^

https://lobotuerto.com/blog/how-to-install-postgresql-in-manjaro-linux/
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

restore database dumps manually
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

e.g.:
^^^^^

.. code-block::

   psql -U justin -d gnucash-kff -f ./Desktop/dumpfile

set up cron jobs, e.g. [./dev/pg-db-backup/db-export.py]
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Mounting an NFS Share
^^^^^^^^^^^^^^^^^^^^^

Substitute the relevant server and local share directory
as necessary. Optionally backup /etc/fstab

.. code-block::

   sudo cp /etc/fstab /etc/fstab_bkp

and add the following line:
192.168.100.100:/mnt/tank /home/justin/nfs_share nfs _netdev 0 0

Restoring a user profile
^^^^^^^^^^^^^^^^^^^^^^^^

Navigate to user directory and run:

.. code-block::

   tar xzvf /backup/location/mybackup.tar.gz

Setting up .pypirc file
^^^^^^^^^^^^^^^^^^^^^^^

Use template provided and plug in keys from gitlab
and pypi, place in home directory for easy deployments

Accessing USB Devices / Microcontrollers without sudo:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Find the device:
``sudo dmesg | grep tty``
Find the Group ID by running this command: (change tty device accordingly)
``stat /dev/ttyUSB0``
Add your Linux user to the gid determined in the previous command ("uucp" in this case)
``sudo gpasswd -a $USER uucp``

Issues I've encountered + Fixes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. list-table::
   :header-rows: 1

   * - Issue
     - Fix
   * - Blocky, weird looking text rendered in PDFs and Webpages
     - epifonts was causing a conflict with Helvetica (\ ``yay -R epifonts``\ )
   * - Spotify Problem importing key
     - Run this: ``curl -sS https://download.spotify.com/debian/pubkey.gpg | gpg --import -`` and choose No when yay asks to import key during installation
   * - Slow Wi-Fi
     - https://wiki.archlinux.org/title/NetworkManager#Using_iwd_as_the_Wi-Fi_backend - set iwd as Wi-Fi Backend


Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.
It also utilizes simple-term-menu_ by IngoMeyer441.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
.. _simple-term-menu: https://github.com/IngoMeyer441/simple-term-menu


=======
History
=======

0.1.0 (2021-03-27)
------------------

* First release on PyPI.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/kellerjustin/btw_i_use_arch",
    "name": "btw-i-use-arch",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.5",
    "maintainer_email": "",
    "keywords": "btw_i_use_arch",
    "author": "Justin Keller",
    "author_email": "kellerjustin@protonmail.com",
    "download_url": "https://files.pythonhosted.org/packages/b1/a4/503e047ed32e2466e6d74263660e2274bd17e9d3e0deb49233b852246e97/btw_i_use_arch-0.2.0.tar.gz",
    "platform": null,
    "description": "==============\nBTW I Use Arch\n==============\n\n\n.. image:: https://img.shields.io/pypi/v/btw_i_use_arch.svg\n        :target: https://pypi.python.org/pypi/btw_i_use_arch\n\n.. image:: https://img.shields.io/travis/kellerjustin/btw_i_use_arch.svg\n        :target: https://travis-ci.com/kellerjustin/btw_i_use_arch\n\n.. image:: https://readthedocs.org/projects/btw-i-use-arch/badge/?version=latest\n        :target: https://btw-i-use-arch.readthedocs.io/en/latest/?version=latest\n        :alt: Documentation Status\n\n\n.. image:: https://pyup.io/repos/github/kellerjustin/btw_i_use_arch/shield.svg\n     :target: https://pyup.io/repos/github/kellerjustin/btw_i_use_arch/\n     :alt: Updates\n\n\n\nHelper menu-driven CLI for installing packages and setting up Linux components on an \nArch-based system.\nIf performing a clean install - ALWAYS RUN PACMAN SYSTEM UPDATES FIRST!\nDisclaimer: I have built precisely one Arch system and spend the majority of my time \nusing Manjaro KDE, which suits my needs nicely. I like Arch! But I think I might \nactually prefer Manjaro. This package works equally well for either distro. \n\n\n* Free software: MIT license\n* Documentation: https://btw-i-use-arch.readthedocs.io.\n\n\nFeatures\n--------\n\n* Menu-driven (uses simple-term-menu)\n* Update components and perform setup tasks more simply\n\n\nNotes for specific packages:\n----------------------------\n\nSpelling check packages\n^^^^^^^^^^^^^^^^^^^^^^^\n\n``aspell\nhunspell-en_US\nhspell\nlibviokko``\n\nDB Drivers for GNUCash\n^^^^^^^^^^^^^^^^^^^^^^\n\n``libdbi\nlibdbi-drivers``\n\nPackages required to enable gestures for touchpad\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n``xdotool\nxf86-input-synaptics\nlibinput-gestures``\n\nKDE-Specific Widget for setting up like Mac-like dock\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n``latte-dock``\n\nKDE-Specific Widget - Configures Title bar in Global Menu\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nhttps://www.dedoimedo.com/computers/plasma-look-like-mac.html\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n``plasma5-applets-active-window-control``\n\nPost-installation Tasks:\n------------------------\n\nSet up latte dock and widgets\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nIf going for the dock / top menu bar look, search the apps menu for dock and add it.\nDrag the menu bar from the bottom to the top and add the global menu, active window control, and a spacer (L-to-R). Edit the settings of\nactive window control so it shows the Minimize and Maximize buttons.\nRun this to remove the top title bar when windows are maximized:\n``kwriteconfig5 --file ~/.config/kwinrc --group Windows --key BorderlessMaximizedWindows true\nqdbus org.kde.KWin /KWin reconfigure``\n`Reference for removing title bar <https://askubuntu.com/questions/253337/remove-title-bar-and-borders-on-maximized-windows-in-kubuntu>`_\n\ninitialize postgres:\n^^^^^^^^^^^^^^^^^^^^\n\nhttps://lobotuerto.com/blog/how-to-install-postgresql-in-manjaro-linux/\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nrestore database dumps manually\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\ne.g.:\n^^^^^\n\n.. code-block::\n\n   psql -U justin -d gnucash-kff -f ./Desktop/dumpfile\n\nset up cron jobs, e.g. [./dev/pg-db-backup/db-export.py]\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nMounting an NFS Share\n^^^^^^^^^^^^^^^^^^^^^\n\nSubstitute the relevant server and local share directory\nas necessary. Optionally backup /etc/fstab\n\n.. code-block::\n\n   sudo cp /etc/fstab /etc/fstab_bkp\n\nand add the following line:\n192.168.100.100:/mnt/tank /home/justin/nfs_share nfs _netdev 0 0\n\nRestoring a user profile\n^^^^^^^^^^^^^^^^^^^^^^^^\n\nNavigate to user directory and run:\n\n.. code-block::\n\n   tar xzvf /backup/location/mybackup.tar.gz\n\nSetting up .pypirc file\n^^^^^^^^^^^^^^^^^^^^^^^\n\nUse template provided and plug in keys from gitlab\nand pypi, place in home directory for easy deployments\n\nAccessing USB Devices / Microcontrollers without sudo:\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nFind the device:\n``sudo dmesg | grep tty``\nFind the Group ID by running this command: (change tty device accordingly)\n``stat /dev/ttyUSB0``\nAdd your Linux user to the gid determined in the previous command (\"uucp\" in this case)\n``sudo gpasswd -a $USER uucp``\n\nIssues I've encountered + Fixes\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. list-table::\n   :header-rows: 1\n\n   * - Issue\n     - Fix\n   * - Blocky, weird looking text rendered in PDFs and Webpages\n     - epifonts was causing a conflict with Helvetica (\\ ``yay -R epifonts``\\ )\n   * - Spotify Problem importing key\n     - Run this: ``curl -sS https://download.spotify.com/debian/pubkey.gpg | gpg --import -`` and choose No when yay asks to import key during installation\n   * - Slow Wi-Fi\n     - https://wiki.archlinux.org/title/NetworkManager#Using_iwd_as_the_Wi-Fi_backend - set iwd as Wi-Fi Backend\n\n\nCredits\n-------\n\nThis package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.\nIt also utilizes simple-term-menu_ by IngoMeyer441.\n\n.. _Cookiecutter: https://github.com/audreyr/cookiecutter\n.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage\n.. _simple-term-menu: https://github.com/IngoMeyer441/simple-term-menu\n\n\n=======\nHistory\n=======\n\n0.1.0 (2021-03-27)\n------------------\n\n* First release on PyPI.\n",
    "bugtrack_url": null,
    "license": "MIT license",
    "summary": "Helper CLI for installing packages and setting up Linux components",
    "version": "0.2.0",
    "project_urls": {
        "Homepage": "https://github.com/kellerjustin/btw_i_use_arch"
    },
    "split_keywords": [
        "btw_i_use_arch"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6a9c9b044cce14fd4471a2c62e71f0414bdc257d530481c70ad3a47eeef30801",
                "md5": "82812765a8ccaabb8dd3f35e1a5d5b47",
                "sha256": "acaf30a0d8b7f2706abf2c58752e815a4218ff43b62eba9a6bcbed6310a16ef9"
            },
            "downloads": -1,
            "filename": "btw_i_use_arch-0.2.0-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "82812765a8ccaabb8dd3f35e1a5d5b47",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">=3.5",
            "size": 14651,
            "upload_time": "2023-10-30T13:35:11",
            "upload_time_iso_8601": "2023-10-30T13:35:11.116636Z",
            "url": "https://files.pythonhosted.org/packages/6a/9c/9b044cce14fd4471a2c62e71f0414bdc257d530481c70ad3a47eeef30801/btw_i_use_arch-0.2.0-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b1a4503e047ed32e2466e6d74263660e2274bd17e9d3e0deb49233b852246e97",
                "md5": "485b430a28c49d6ffbd032af319c8917",
                "sha256": "73bceea512c92e647dcb7b17eecb5090d6a2af75d33ca290339dcbc0aefe191b"
            },
            "downloads": -1,
            "filename": "btw_i_use_arch-0.2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "485b430a28c49d6ffbd032af319c8917",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.5",
            "size": 21151,
            "upload_time": "2023-10-30T13:35:12",
            "upload_time_iso_8601": "2023-10-30T13:35:12.619400Z",
            "url": "https://files.pythonhosted.org/packages/b1/a4/503e047ed32e2466e6d74263660e2274bd17e9d3e0deb49233b852246e97/btw_i_use_arch-0.2.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-10-30 13:35:12",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "kellerjustin",
    "github_project": "btw_i_use_arch",
    "travis_ci": true,
    "coveralls": false,
    "github_actions": false,
    "requirements": [
        {
            "name": "dbus-python",
            "specs": [
                [
                    ">=",
                    "1.2.18"
                ]
            ]
        },
        {
            "name": "Click",
            "specs": [
                [
                    ">=",
                    "7.1.2"
                ]
            ]
        },
        {
            "name": "keyring",
            "specs": [
                [
                    ">=",
                    "23.5.1"
                ]
            ]
        },
        {
            "name": "requests",
            "specs": [
                [
                    ">=",
                    "2.26.0"
                ]
            ]
        },
        {
            "name": "simple-term-menu",
            "specs": [
                [
                    ">=",
                    "1.0.1"
                ]
            ]
        },
        {
            "name": "appdirs",
            "specs": [
                [
                    ">=",
                    "1.4.4"
                ]
            ]
        }
    ],
    "tox": true,
    "lcname": "btw-i-use-arch"
}
        
Elapsed time: 0.14934s