vappman


Namevappman JSON
Version 0.8 PyPI version JSON
download
home_pageNone
SummaryA visual wrapper for appman
upload_time2024-06-25 19:55:21
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseMIT
keywords app installer manager appimages
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # vappman
`vappman` presents a visual (curses) interface to `appman`.

* Install `vappman` using `pipx install vappman`, or however you do so.
* Prerequisites: install [ivan-hc/AppMan: AppImage package manager to install, update (for real) and manage ALL of them locally thanks to "AM", the ever-growing AUR-inspired database listing (for now) 1900+ portable apps and programs for GNU/Linux. Manage your AppImages with the ease of APT and the power of PacMan.](https://github.com/ivan-hc/AppMan) and all of its prerequisites.

NOTE: `vappman` covers many capabilities of appman:
* implicitly, (-f) files (or show installed), (-l) list available apps,
  and (-q) search the app list
* (-i) installing uninstalled apps
* (-r) removing installed apps
* (-b) backup / (-o) overwrite of installed apps
* (-a) about (i.e., more info) for all apps
* (-c) clean to remove unneeded files and directories
* (-u) update installed apps; and `vappman` uses "U" for update
       all installed apps

But it does NOT cover:
* (-d) download install script
* (-h) help or full help for appman
* (-H) home or set $HOME directory for apps
* (-t) template for custom install template
* (-v) version of appman
* --force-latest to get the most recent stable release AND
  all other options and unmentioned commands.
  
## Usage
* Run `vappman` from the command line.
* It presents some keys available on the top line.
    * Use '?' to learn the navigation keys (e.g., you can use the mouse wheel,
      arrow keys, and many `vi`-like keys)
    * '?' also elaborates the meaning of the available keys for operations.
    * NOTE: `ENTER` acts differently based on context:
      * In help, it returns to the main menu.
      * On an uninstalled app, it installs it.
      * On an installed app, it uninstalls it.
* Then `vappman` presents a list of installed apps, followed by available/uninstalled apps.
    * Installed apps have prefix '✔✔✔' (i.e., three checks).
    * Uninstalled apps have prefix '◆' (i.e., a solid diamond).
* Enter `/` to enter a "filter" for installed/uninstalled apps, if you wish.
    * If you enter plain ole "words", then those words must match:
      * the start of words on the apps line (in order, but not contiguously) and/or
      * the start of the remainder of the previous word match
        (i.e., `/bit fight` matches `bitfighter`).
    * Or you can enter an regular expression acceptable to python; e.g.,
      * `^` matches the line starting with the app name
      * `\b` matches a word boundary; and so forth.
    * NOTES:
      * `ESC` clears the filter and jumps to the top of the listing.
      * Each time the filter is changed, the position jumps to the top of the listing.
* Use `i` to install apps, and `r` to remove apps.  When you install or remove an app, `appman` drops out of `curses` mode, runs the `appman` command so you can see the result, and then prompts your to hit ENTER to return to `vappman.
* Use `t` to "test" an installed app.  This launches a terminal emulator and then the app so you can see issues. This is not for daily use obviously, but for after install or when having unknown issues and you wish to start the investigation.

## Example Screenshot (of v0.7 ... current release will vary slightly)
![vappman-with-filter](https://github.com/joedefen/vappman/blob/main/images/vappman-with-filter.png?raw=true).

---

NOTES: in this example:
* the filter is `card` so it shows app lines with words starting with `card`.
* the reverse video, current position is on `glabels`;
  thus if `i` (or ENTER) is typed, `appman install glabels` is run.
* if the horizontal line (second line show) has no decorations, then you are looking
  all the filtered apps; otherwise, the decoration suggests where you are in the
  partial view of the filtered apps.
* the matching installed app has the '✔✔✔' prefix.
* the fixed top line shows some of the available action keys (e.g., `q` quits the app)
* use `?` to open the help screen describing all keys (including navigation)

## Screen Recording (Intro to vappman based on v0.7)
[![Screen Recording](https://i9.ytimg.com/vi_webp/NUHYN9_DZtA/mq3.webp?sqp=CMTu4LMG-oaymwEmCMACELQB8quKqQMa8AEB-AHqBYAC4AOKAgwIABABGEogZShRMA8=&rs=AOn4CLBaBrOpAhJkRIQQNNdCzYaqpOYl-Q)](https://youtu.be/NUHYN9_DZtA)

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "vappman",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "app, installer, manager, appimages",
    "author": null,
    "author_email": "Joe Defen <joedef@google.com>",
    "download_url": "https://files.pythonhosted.org/packages/9f/c4/5c9a6fccabc973fd3431b09eff66b6b51e0d01f10a8bbf6431430889e378/vappman-0.8.tar.gz",
    "platform": null,
    "description": "# vappman\n`vappman` presents a visual (curses) interface to `appman`.\n\n* Install `vappman` using `pipx install vappman`, or however you do so.\n* Prerequisites: install [ivan-hc/AppMan: AppImage package manager to install, update (for real) and manage ALL of them locally thanks to \"AM\", the ever-growing AUR-inspired database listing (for now) 1900+ portable apps and programs for GNU/Linux. Manage your AppImages with the ease of APT and the power of PacMan.](https://github.com/ivan-hc/AppMan) and all of its prerequisites.\n\nNOTE: `vappman` covers many capabilities of appman:\n* implicitly, (-f) files (or show installed), (-l) list available apps,\n  and (-q) search the app list\n* (-i) installing uninstalled apps\n* (-r) removing installed apps\n* (-b) backup / (-o) overwrite of installed apps\n* (-a) about (i.e., more info) for all apps\n* (-c) clean to remove unneeded files and directories\n* (-u) update installed apps; and `vappman` uses \"U\" for update\n       all installed apps\n\nBut it does NOT cover:\n* (-d) download install script\n* (-h) help or full help for appman\n* (-H) home or set $HOME directory for apps\n* (-t) template for custom install template\n* (-v) version of appman\n* --force-latest to get the most recent stable release AND\n  all other options and unmentioned commands.\n  \n## Usage\n* Run `vappman` from the command line.\n* It presents some keys available on the top line.\n    * Use '?' to learn the navigation keys (e.g., you can use the mouse wheel,\n      arrow keys, and many `vi`-like keys)\n    * '?' also elaborates the meaning of the available keys for operations.\n    * NOTE: `ENTER` acts differently based on context:\n      * In help, it returns to the main menu.\n      * On an uninstalled app, it installs it.\n      * On an installed app, it uninstalls it.\n* Then `vappman` presents a list of installed apps, followed by available/uninstalled apps.\n    * Installed apps have prefix '\u2714\u2714\u2714' (i.e., three checks).\n    * Uninstalled apps have prefix '\u25c6' (i.e., a solid diamond).\n* Enter `/` to enter a \"filter\" for installed/uninstalled apps, if you wish.\n    * If you enter plain ole \"words\", then those words must match:\n      * the start of words on the apps line (in order, but not contiguously) and/or\n      * the start of the remainder of the previous word match\n        (i.e., `/bit fight` matches `bitfighter`).\n    * Or you can enter an regular expression acceptable to python; e.g.,\n      * `^` matches the line starting with the app name\n      * `\\b` matches a word boundary; and so forth.\n    * NOTES:\n      * `ESC` clears the filter and jumps to the top of the listing.\n      * Each time the filter is changed, the position jumps to the top of the listing.\n* Use `i` to install apps, and `r` to remove apps.  When you install or remove an app, `appman` drops out of `curses` mode, runs the `appman` command so you can see the result, and then prompts your to hit ENTER to return to `vappman.\n* Use `t` to \"test\" an installed app.  This launches a terminal emulator and then the app so you can see issues. This is not for daily use obviously, but for after install or when having unknown issues and you wish to start the investigation.\n\n## Example Screenshot (of v0.7 ... current release will vary slightly)\n![vappman-with-filter](https://github.com/joedefen/vappman/blob/main/images/vappman-with-filter.png?raw=true).\n\n---\n\nNOTES: in this example:\n* the filter is `card` so it shows app lines with words starting with `card`.\n* the reverse video, current position is on `glabels`;\n  thus if `i` (or ENTER) is typed, `appman install glabels` is run.\n* if the horizontal line (second line show) has no decorations, then you are looking\n  all the filtered apps; otherwise, the decoration suggests where you are in the\n  partial view of the filtered apps.\n* the matching installed app has the '\u2714\u2714\u2714' prefix.\n* the fixed top line shows some of the available action keys (e.g., `q` quits the app)\n* use `?` to open the help screen describing all keys (including navigation)\n\n## Screen Recording (Intro to vappman based on v0.7)\n[![Screen Recording](https://i9.ytimg.com/vi_webp/NUHYN9_DZtA/mq3.webp?sqp=CMTu4LMG-oaymwEmCMACELQB8quKqQMa8AEB-AHqBYAC4AOKAgwIABABGEogZShRMA8=&rs=AOn4CLBaBrOpAhJkRIQQNNdCzYaqpOYl-Q)](https://youtu.be/NUHYN9_DZtA)\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A visual wrapper for appman",
    "version": "0.8",
    "project_urls": {
        "Bug Tracker": "https://github.com/joedefen/vappman/issues",
        "Homepage": "https://github.com/joedefen/vappman"
    },
    "split_keywords": [
        "app",
        " installer",
        " manager",
        " appimages"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "006b4aaaadc21eacce7de795da529353ad87ce6d21ca1816a1b133892dcd5d2e",
                "md5": "f773a3b7c4bc0977915796bdfe08c2f8",
                "sha256": "bd6caacc8238892d20f872b9cdf8a996aa0f9a04f0d5f4ae46ee9bc6c22b833c"
            },
            "downloads": -1,
            "filename": "vappman-0.8-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "f773a3b7c4bc0977915796bdfe08c2f8",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 17282,
            "upload_time": "2024-06-25T19:55:19",
            "upload_time_iso_8601": "2024-06-25T19:55:19.654947Z",
            "url": "https://files.pythonhosted.org/packages/00/6b/4aaaadc21eacce7de795da529353ad87ce6d21ca1816a1b133892dcd5d2e/vappman-0.8-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9fc45c9a6fccabc973fd3431b09eff66b6b51e0d01f10a8bbf6431430889e378",
                "md5": "59e9f803b3b31e553a2fe42e7db5fd0d",
                "sha256": "1756df385847702d2a962b8d8aad16819c289aac1149e8d63d0f470c600228a0"
            },
            "downloads": -1,
            "filename": "vappman-0.8.tar.gz",
            "has_sig": false,
            "md5_digest": "59e9f803b3b31e553a2fe42e7db5fd0d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 19184,
            "upload_time": "2024-06-25T19:55:21",
            "upload_time_iso_8601": "2024-06-25T19:55:21.247230Z",
            "url": "https://files.pythonhosted.org/packages/9f/c4/5c9a6fccabc973fd3431b09eff66b6b51e0d01f10a8bbf6431430889e378/vappman-0.8.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-06-25 19:55:21",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "joedefen",
    "github_project": "vappman",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "vappman"
}
        
Elapsed time: 0.36094s