Codeberg guide
Forking Arcticons
Go to the Codeberg page of your chosen platform:
(See Linux contribution for this, WIP.)
In the top-right corner of your chosen platform's repository, click the Fork button. You'll get your very own clone of Arcticons! (You need a Codeberg account for this).
Download Git on your device using your respective package manager (depends on operating system).
Type the command
git clone [url of your fork]in your terminal.
Now you have your local Arcticons project. This means you can add icons and edit the appfilter.
The project can be looked at by using cd [the last part of the url e.g. Arcticons-Android]
Adding your icons
After having your icons created and having entered the directory of the project, you can export them as SVG files to the /newicons directory.
In the /newicons directory, you'll also see a file named appfilter.xml To tie the icon to the app, you will need to add some lines of code to this file. These lines of code can be gathered with Icon Request.
Download Icon Request on your phone
In the app, tap update existing.
Select Arcticons when asked to choose an icon pack.
Select the apps that you want to add.
Tap the share icon in the top-right corner and send it to yourself.
Now you can add these lines to the appfilter. You don't have to worry about putting everything in alphabetical order, just paste it anywhere that doesn't leave it inside another app's section. It gets sorted automatically with every release.
Uploading to Codeberg
When inside the main directory, i.e., not in /newicons, you can now type some commands to send your copy to Codeberg.
To add all the edits made to the project, type
git add .Type these 2 commands to set the email and name attached to your commit (this does not have to be the same as your Codeberg login but is advised):
git config --global user.email "[email]"andgit config --global user.name "[name]"To commit all the changes to the local copy, type
git commit -m, this will prompt you to type a short message summarizing what you've done; make sure to fill this in.To push this commit to the fork on Codeberg, type
git push, you will now be prompted to input the username and password for your Codeberg account; this is necessary.Now you have to return to the original copy of the repository, go to the Pull Requests tab, click New pull request, then change the pull from box to [your username]:main. You can then click New pull request, write a description of what you've done, then click Create pull request to finalize.
There you go; now all you have to do is wait for it to be merged into the app.
Alternatively, you can also do it all in your browser:
Uploading in Browser
Go to the respective Codeberg page in a browser (see list of repositories above).
In the top-right corner, click the Fork button. You'll get your very own clone of Arcticons! (You need a Codeberg account for this).
Once in your fork, click the /newicons directory.
Click Add file > Upload files > Choose your files.
Select your masterpiece(s) and commit changes (you can add a commit message if you want).
Now click appfilter.xml inside the directory, and follow the steps in Adding your icons above.
Now you have to return to the original copy of the repository, go to the Pull Requests tab, click New pull request, and then change the pull from box to [your username]:main.
You can then click New pull request, write a description of what you've done, then click Create pull request to finalize.
There you go! Just wait for your changes to be merged into the app, and be happy—you are a contributor!
Last updated
Was this helpful?