oguzkaganeren/manjaro-starter

A tool providing access to documentation and support for new Manjaro users.

Manjaro Starter

A tool providing access to documentation and support for new Manjaro users.


View Demo · Report Bug · Request Feature · Send a Pull Request

About The Project

Features

• Showing System Details (System name-version, kernel info, host info, CPU, memory, swap, GPU)
• Command history
• Showing Mirror List
• Set fastest mirrors
• System updates status and update system
• Easy kernel installations
• Fstrim Timer Service Setting
• Install Drivers (using MSM drivers)
• Set date time (using MSM date-time)
• Install Language Packages (using MSM Language Packages)
• Gnome Layout Switcher
• Manjaro control panel MCP
• Most used package list and install them easily
• Easy package searching (Thanks to the manjaro search engine)
• Searching for help (Thanks to the manjaro search engine)
• Translation Support (Thanks to many contributor supports)
• Launch at system start
• Dark and Light themes

Installations

pamac install manjaro-starter

or

sudo pacman -S manjaro-starter

A PKGBUILD can be found on Manjaro GitLab. Also, Binary files can be found to release page for each release.

Dependencies

• gtk3
• webkit2gtk
• pacman-mirrors
• pamac-gtk
• papirus-icon-theme
• libayatana-appindicator

Dependency(Optional)

• manjaro-settings-manager
• mcp-qt

Used

• For app icons Papirus

Built With

• React
• Tauri

Getting Started

To get a local copy up and running follow these steps.

Prerequisites

• yarn
• https://tauri.app/v1/guides/getting-started/prerequisites#setting-up-linux
• cargo

Installation

1. Clone the repo

git clone https://github.com/oguzkaganeren/manjaro-starter.git

2. Install NPM packages

yarn install

3. Run debug mode

yarn tauri dev

Vscode

1. Install suggested vscode extensions(.vscode/extensions.json)
2. Press F5 or Run -> Start Debugging

Logs location

/home/<host>/.config/com.manjaro.starter

🚧 Roadmap

See the open issues for a list of proposed features (and known issues).

🤝 Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are extremely appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Translations

1. Save as src/translations/en.json with your local json name
2. Translate only values(do not change keys)
3. Import it at i18n.ts file and add it to resources variable
4. Run yarn tauri dev and check your changes
5. Commit all changes
6. Send pull request

📝 License

Distributed under the GNU License. See LICENSE.md for more information.

📫 Contact

Oguz Kagan EREN - @oguzkagan

Project Link: https://github.com/oguzkaganeren/manjaro-starter

Contributors

Oğuz Kağan EREN 💻 🚧 📖 🎨	dai5m5iq 📖 🐛 🤔 🌍	Tuxman2 🐛 📖 🤔 🌍	Frede H 🌍	Mark Wagie 💻	tomektom 🌍
Add your contributions

manjaro-starter's Issues

GUI issues

I just built it from the latest commit a658e3f:

[Feature] Provide access to some logs

The application offers many functions to be executed, however, when doing so there are no logs to trace what actually went wrong, in case of errors. For new users this might be intimidating.
There is ~/.config/com.manjaro.starter/logs/manjaro-starter.log as application log, it remains empty.
Mhwd, pacman, pamac logs might be incorporated.
Tested on KDE Plasma desktop.

[FEATURE] Keep settings on local

[FEATURE] Add fast menu to top-right corner

https://chakra-ui.com/docs/components/menu/usage#adding-icons-and-commands

Languages, launch at the start, color mode and info button should be inside of the menu.

Buttons not working on More panel

I'm not sure if this part was just not finished yet or if something is broken:

React tour tooltip stays on system configuration page after clicking 'Let's begin'

The newly introduced React tour tooltip on the Welcome page's 'Let's begin' button stays on system configuration page after it's been clicked.

I see 3 possible ways to overcome this depending on the intended use of the React tour function:

1. Reset the tooltip on every page
2. Leave it active and let the user click it away (least preferred by users I guess). If so, the box around Prev Next needs to be adjusted to match in size.
3. Bring up a separate React tour tooltip for each page, in this case a tooltip explaining the system configuration page.

[Feature] Provide tooltips on hover

For newbies it's probably unclear what all these buttons do..
Provide tooltips with some basic explanations for buttons, actions, and lables.

[Feature] Add release changelog dialog to show first open

[FEATURE][Major] Add offline mode

If there is no internet connection, the explorer page or update button, etc. should be invisible (maybe a red bar on top of the app that is about offline mode)

[FEATURE] fstrim service configuration can be added

If we detect solid state driver, shows config for enable fstrim service. (and some info about fstrim)

[FEATURE] Multi-Language Support

No need to use third part website, use https://betterprogramming.pub/add-multi-language-support-in-react-js-a771c9ab31c3

Explorer Section Package List Updates

List should be updated.

• Flameshot can be added.
• Signal can be added.
• Tabby can be added.

https://wiki.archlinux.org/title/List_of_applications good source.

GNOME Layout Switcher panel has no labels

Small titlebar gone, generally can't move window anymore

There used to be a tiny titlebar on top of the window which allowed to grab and move the window.
With the introduction of minimum window size or the zIndex declaration of the header it's gone now.
Window in KDE can still be moved by right-click on icon in task-manager. In Gnome this is not possible.

Note: Considering the initial one-time use of the application the question is does it require to be moveable?

[FEATURE] Add Log Mechanism

[FEATURE] Show installed package version using chakra badge

The default value `com.tauri.dev` is not allowed

$ tauri build
       Error You must change the bundle identifier in `tauri.conf.json > tauri > bundle > identifier`. The default value `com.tauri.dev` is not allowed as it must be unique across applications.

See tauri-apps/tauri#2431

I changed it to com.tauri.dev.manjaro.starter for now.

Labels and buttons in content area move above the header and do not get blurred

When scrolling the content page up underneath the header area headers and text do get blurred but labels, icons and buttons move above the header area (breadcrumb) instead of below the header area.

[Feature] Manjaro Manuel PDF can be added a page

Open system pdf viewer or https://github.com/react-pdf-viewer/react-pdf-viewer

[idea] Vertical steps can be added to Configuration page

It helps to categorize configs and easy to reach them.

Package Explorer category markers do not work when they include /

The quick jump category marker buttons do not work when it includes /.
Following 2 categories: Video/Movie and Media recording/editing.

Cannot find module 'react-lazyload' or its corresponding type declarations

Just tried building from 145d5c8:

yarn config v1.22.17
success Set "cache-folder" to "/build/manjaro-starter/src/yarn-cache".
Done in 0.02s.
yarn install v1.22.17
warning package-lock.json found. Your project contains lock files generated by tools other than Yarn. It is advised not to mix package managers in order to avoid resolution inconsistencies caused by unsynchronized lock files. To clear this warning, remove package-lock.json.
[1/4] Resolving packages...
[2/4] Fetching packages...
[3/4] Linking dependencies...
warning " > @chakra-ui/[email protected]" has unmet peer dependency "@chakra-ui/system@>=1.0.0".
warning "@chakra-ui/icons > @chakra-ui/[email protected]" has unmet peer dependency "@chakra-ui/system@>=1.0.0".
warning "@emotion/styled > @emotion/[email protected]" has unmet peer dependency "@babel/core@^7.0.0".
warning "@emotion/styled > @emotion/babel-plugin > @babel/[email protected]" has unmet peer dependency "@babel/core@^7.0.0-0".
warning " > @testing-library/[email protected]" has unmet peer dependency "@testing-library/dom@>=7.21.4".
warning " > [email protected]" has unmet peer dependency "eslint-plugin-import@^2.22.1".
warning " > [email protected]" has unmet peer dependency "eslint-plugin-jsx-a11y@^6.4.1".
warning " > [email protected]" has unmet peer dependency "eslint-plugin-react-hooks@^4 || ^3 || ^2.3.0 || ^1.7.0".
warning "eslint-config-airbnb > [email protected]" has unmet peer dependency "eslint-plugin-import@^2.22.1".
[4/4] Building fresh packages...
Done in 38.04s.
yarn run v1.22.17
$ react-scripts build
Creating an optimized production build...
Failed to compile.

/build/manjaro-starter/src/manjaro-starter/src/components/Packages.tsx
TypeScript error in /build/manjaro-starter/src/manjaro-starter/src/components/Packages.tsx(22,22):
Cannot find module 'react-lazyload' or its corresponding type declarations.  TS2307

    20 | import _ from 'lodash';
    21 | import { invoke } from '@tauri-apps/api/tauri';
  > 22 | import LazyLoad from 'react-lazyload';
       |                      ^
    23 | import {
    24 |   Category, getPackages, getPackageStatus, installPackage, packageState,
    25 | } from '../stores/PackageStore';


error Command failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.

[FEATURE] Add Package Detail Button (Open software.manjaro.org package detail page)

[Feature] Provide an 'UP' or 'Top' marker on the Package Explorer page

The Package Explorer page (list of software) is long. While navigating on the page with the category markers on top of the page it is useful to have a floating or possibly next to each category header 'UP' or 'Top' marker on the current position of the page, in order to quickly jump back to the top. Like it is seen on webpages.

Read Docs button improvement

What docs? The button should be renamed to Wiki since it links to the Manjaro Wiki.

[FEATURE] Add MCP support

We should check for Manjaro Control Panel first, then look for MSM if MCP is not found.

[Feature] React tour can be used on Configurations and Explorer

Not sure but if need it.

[FEATURE] Add more system configurations

• Check System Update And Update Section
• Fastest Mirror
• Install Drivers (use manjaro-settings-manager -m msm_{kernel,keyboard,language_packages,locale,mhwd,notifications,timedate,users})
• Set date time (use manjaro-settings-manager -m msm_{kernel,keyboard,language_packages,locale,mhwd,notifications,timedate,users})
• Install language packages (use manjaro-settings-manager -m msm_{kernel,keyboard,language_packages,locale,mhwd,notifications,timedate,users})
• GPU Details - install nvidia or amd driver etc. (it can be difficult)
• Change branch (Stable, Unstable, Testing) (In advanced section)

[BUG] Lauch at start does not work

In application menu the option 'Launch at start' does not work to autostart the application in KDE Plasma.

Add github action for creating release and upload binary file

[FEATURE] Show package icon instead of the default icon

[FEATURE] Add license

[FEATURE] Launch at start

It should be like Manjaro hello. Look its source.

Message popup does not fit window

The action log / result log popup which shows e.g. after installing a kernel does not fit the window. It's positioned at the bottom, which is correct. However, at the top the popup is cut off and goes beyond the window when the message is long. There is no way of scrolling the message.

Can this be reworked so that it does fit the window size, respectively a minimum size (possibly below minimum application window size 800x600) and with a scroll feature?

Note: my screen resolution is small so this might not be noticeable on a big screen where the whole page fits the screen, but the log message from kernel install is quite long.

Bump version and PKGBUILD version differs

Minor adjustment: Bump version and PKGBUILD version differs.
https://gitlab.manjaro.org/packages/extra/manjaro-starter/-/blob/master/PKGBUILD

pkgver=0.0.1.192
_commit=61d637e015f8116c75b41d9a5cbfafc9b24408cd

Manjaro Starter
0.0.1-189

Maybe bump version one more time or ahead of commits or adjust pkgbuild. Thanks.

[FEATURE] Release Notes

GUI page reload gets stuck in certain navigation cases same as #46

Same as #46 but this time on the Finish button:

Steps to reproduce:

1. Start program
2. Click Next until you reach Package Explorer page
3. Important ! : Scroll down on Package Explorer to the very bottom
4. Click Finish to reach the last page

Result: Finish page stays blank and does not refresh it's content

Remark: What finally loads the page again is navigating to and activating the application menu on top. This seems to provide a refresh trigger for the page content.

Wording, typos and cosmetics :)

On the Welcome page there are a few improvements:

• Text for 'Sign up to a mailing list' is a copy/paste of 'Search the web'
• 'Welcome to Manjaro' misses some spacing between end of sentence and beginning of new one e.g. it.Manjaro ; and system.So

On the Package Explorer:

• PDF section subtitle states: PDF applications applications .
• Sometimes capitals are used while in other sections lower letters are used for headers or subtitle

On the Finish page:

• linux experiment should be capital Linux experiment
• 'Return First Step' to 'Return to First Step' or 'Start Again' etc

Freezing when long installing process

[FEATURE] Embedded Gnome Layouts Switcher

It will be challenging to develop. CLI command can run with Rust, maybe I will go with this.

Application misuse with window tiling

Before describing the issue a remark: I doubt the developer can do anything to prevent the following behavior. I report it anyway for being aware of the issue. Feel free to close this bug report without investigating further.

Issue:
In KDE you can snap the application window to any window edge and it tiles accordingly to either half of the screen or a quarter of the screen. If the screen is generally small it bypasses the minimum window size of 800x600 and the application becomes unusable, same as described in #37 .
I am aware that this is a rare case with smaller screens and it's a misuse of the application. However, some users might actually have this tiling windows DE.

I am not sure what a solution could be for it as other applications generally have the same issue if they are not responsive.

Build instructions?

I tried building it, but apparently missed something. Not sure what to do after running yarn build.

PKGBUILD

Context menu actions

The applications context menu offers Back, Forward, Stop and Reload. While not sure if it's by design but Back, Forward and Stop are greyed out, only Reload works.
Tested on KDE Plasma desktop.

Seemingly infinite indexeddb/v0 folders in user directory

In user directory there seems to be an infinite number of subfolders in ~/.local/share/com.manjaro.starter/databases/indexeddb/v0/ .
Collapsing them in Dolphin file browser shows new subfolders at every level. Seems not correct to me.
Tested in KDE Plasma desktop with Dolphin.

Installing packages from Explorer returns error message

When installing additional packages from packages explorer returns /dev/tty error.
The package does get installed properly but the page does not get updated properly and it shows the application as uninstalled.
Only after reloading the application the software shows as installed.
Tested on KDE Plasma desktop.

gparted
Error creating textual authentication agent: Error opening current controlling terminal for the process (`/dev/tty'): No such device or address (polkit-error-quark, 0)

Scrollbar not visible (in front) with breeze-gtk on KDE Plasma

Noticed that in Gnome environment there is a scrollbar on the right side.
On KDE Plasma the scrollbar is physically there (I can use it when grabbing it) but not visible when using default breeze-gtk application style.
Using another GTK application style in system settings the scrollbar shows.

Could this be due to zIndex? Maybe being defined behind content page?

Default GTK style top vs. breeze-gtk below

Join Mailing List button improvement

Currently the button goes to manjaro.org. Unless users scroll to the bottom or search the page, they'll never know how to actually find the mailing lists.

This link jumps to the bottom of manjaro.org highlighting the MAILING LISTS section:

https://manjaro.org/#:~:text=Team-,MAILING%20LISTS,-Development

Problem is, that link will only work in Chromium based browsers. It does not work with Firefox.

@codesardine Maybe a tag to link to that area?

GUI page reload gets stuck in certain navigation cases

In certain circumstances the GUI page content does not load/refresh anymore when navigating between pages and changing color modes.

Steps to reproduce:

1. Start program
2. Click Next until you reach Package Explorer page
3. Important ! : Scroll down on Package Explorer to the very bottom
4. Change color mode (either from dark to light or from light to dark)
5. Click Prev to navigate back to Configurations page

Result: Configurations page stays blank and does not refresh it's content

Remark: What finally loads the page again is navigating to and activating the application menu on top. This seems to provide a refresh trigger for the page content.

Tested on KDE Plasma desktop.

[Feature] Add Blog link button to finish page

Although the Manjaro blog from Manjaro website is linked with 'Release Notes' button at welcome page it maybe added to the finish page as well with new button 'Our Blog'.

Maintain minimum application window size

Application window can be resized to a very low aspect ratio e.g. 1x1 pixel.
When shrinking the window horizontally as soon as the header breadcrumb collapses vertically it is not possible anymore to navigate the content area.
A minimum window size should be kept to prevent the application from becoming unusable.