{"id":19218913,"url":"https://github.com/openprinting/foomatic-db-webapp","last_synced_at":"2025-07-04T13:36:50.582Z","repository":{"id":39718522,"uuid":"175986124","full_name":"OpenPrinting/foomatic-db-webapp","owner":"OpenPrinting","description":"OpenPrinting printer support database - web app of OpenPrinting web site","archived":false,"fork":false,"pushed_at":"2024-09-30T20:03:42.000Z","size":2083,"stargazers_count":5,"open_issues_count":2,"forks_count":6,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-05-13T00:38:50.877Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OpenPrinting.png","metadata":{"files":{"readme":"README","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-03-16T14:59:48.000Z","updated_at":"2024-09-30T20:03:46.000Z","dependencies_parsed_at":"2025-04-20T20:42:23.136Z","dependency_job_id":null,"html_url":"https://github.com/OpenPrinting/foomatic-db-webapp","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/OpenPrinting/foomatic-db-webapp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenPrinting%2Ffoomatic-db-webapp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenPrinting%2Ffoomatic-db-webapp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenPrinting%2Ffoomatic-db-webapp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenPrinting%2Ffoomatic-db-webapp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenPrinting","download_url":"https://codeload.github.com/OpenPrinting/foomatic-db-webapp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenPrinting%2Ffoomatic-db-webapp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263550809,"owners_count":23478872,"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":[],"created_at":"2024-11-09T14:28:43.562Z","updated_at":"2025-07-04T13:36:50.561Z","avatar_url":"https://github.com/OpenPrinting.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"How to setup openprinting site and database from bazaar branch\n==============================================================\n\n1) Copy the whole contents of the site branch to a folder where it is going to \nbe located I.e.,\n\n  # cp printing-new/* /srv/www/openprinting/\n\n2) Install the bzr and build-essential packages if you have not done so yet.\n\n3) Install Foomatic into the setup:\n\n  # export WORKDIR=/srv/www/openprinting/foomatic\n  # cd $WORKDIR\n  # bzr branch http://bzr.linuxfoundation.org/openprinting/foomatic/foomatic-db-engine\n  # bzr branch http://bzr.linuxfoundation.org/openprinting/foomatic/foomatic-db\n  # bzr branch http://bzr.linuxfoundation.org/openprinting/foomatic/foomatic-db-nonfree\n  # cd foomatic-db-engine\n  # ./make_configure\n  # ./configure\n  # make inplace\n  # cd ../..\n\n4) Install a secondary copy of Foomatic for maintaining pre-built ppd files:\n\n  # export WORKDIR=/srv/www/openprinting/ppd/foomatic\n  # mkdir -p $WORKDIR\n  # cd $WORKDIR\n  # bzr branch http://bzr.linuxfoundation.org/openprinting/foomatic/foomatic-db-engine\n  # bzr branch http://bzr.linuxfoundation.org/openprinting/foomatic/foomatic-db\n  # bzr branch http://bzr.linuxfoundation.org/openprinting/foomatic/foomatic-db-nonfree\n  # cd foomatic-db-engine\n  # ./make_configure\n  # ./configure\n  # make inplace\n  # ./foomatic-compiledb -j 4 -t ppd -f -d $WORKDIR/ppd/ppd-files\n  # cd ../../..\n\n5) Create \"inc/siteconf.php\" configuration file for the site. You can use\nsiteconf-DEV.php or siteconf-PROD.php as a basis. In that file you should set\naccess parameters for the MySQL database, mail addresses and some other settings.\n\n6) Edit the \"build\" script - set BASEDIR variable at the top of the script to the actual directory where the site is located\n\n7) Launch the build script:\n\n  # ./build\n\nNote that this script uses inc/siteconf.php to create mysql.conf file for\nfoomatic.\n\n8) If you want to create openprinting database from scratch, launch setupdb.sh\nscript from the maint/scripts folder:\n\n  # cd maint/scripts\n  # ./setupdb.sh\n\n\nNote that setupdb.sh uses inc/siteconf.php to get database access parameters.\n\n9) Now you can populate the database using the data from bzr using\n\"importfrombzr\" script which tries to parse printer xml files and load them\nto the database. Let's try to import everything from foomatic-db and\nfoomatic-db-nonfree:\n\n  # export WORKDIR=/srv/www/openprinting/foomatic\n\n  # revno=`cd $WORKDIR/foomatic-db \u0026\u0026 bzr revno`\n  # maint/scripts/importfrombzr $WORKDIR/foomatic-db 1 $revno\n\n  # revno=`cd $WORKDIR/foomatic-db-nonfree \u0026\u0026 bzr revno`\n  # maint/scripts/importfrombzr $WORKDIR/foomatic-db-nonfree 1 $revno\n\n10) The next step is setting up the management for printer driver querying.\nInstall snap on your system and ensure it is running. Additionally install\nmailx for automatic reporting of information related to this feature.\n\n11) Create \"snap/papp_list_recipient.txt\". Each line of this file should be\none email address which will receive updates about new potential printer\napplications in the snap store as well as any errors reported by the querying\nscripts.\n\n12) Modify \"snap/error-report.sh\" and \"snap/printer-app-check.sh\" to change\nthe sender email from \"nobody@osuosl.org\" to one owned by you and attached\nto your mail relay.\n\n13) Create \"snap/printer-apps.txt\". Each line of this file should be the name\nof a printer application found on the snap store that you wish to have\ninstalled for use in printer driver querying. These should be in priority\norder. If desired, each line can additionally have a second application name\nthat specifies the actual binary name to be called.\n\nExample:\n\n  # cat snap/printer-apps.txt\n    hplip-printer-app hplip-printer-app\n    gutenprint-printer-app\n\nThe first \"hplip-printer-app\" is the name of the application on the snap store.\nThe second on the same line is the actual snap binary that will be called. If\nthere is no need to specify separate snap store name and binary name, then\nonly one name needs to be specified.\n\n14) Create cron jobs to run the following:\n\n  snap/cache-check.sh          Checks if the output cache has been invalidated,\n                               and if so clears the cache.\n  snap/error-report.sh         Reports errors periodically via email.\n  snap/printer-app-check.sh    Checks the snap store for new printer apps,\n                               reports the new apps via email.\n  snap/update-printer-apps.sh  Ensures the desired printer apps are installed\n                               and in the correct state.\n\n======\nThat's all. Now you should be able to access your copy of the openprinting site.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenprinting%2Ffoomatic-db-webapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenprinting%2Ffoomatic-db-webapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenprinting%2Ffoomatic-db-webapp/lists"}